@google-cloud/discoveryengine 2.1.0 → 2.3.0

package/README.md

@@ -125,6 +125,10 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 
 | Sample                      | Source Code                       | Try it |
 | --------------------------- | --------------------------------- | ------ |
+| Cmek_config_service.delete_cmek_config | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/cmek_config_service.delete_cmek_config.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/cmek_config_service.delete_cmek_config.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Cmek_config_service.get_cmek_config | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/cmek_config_service.get_cmek_config.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/cmek_config_service.get_cmek_config.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Cmek_config_service.list_cmek_configs | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/cmek_config_service.list_cmek_configs.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/cmek_config_service.list_cmek_configs.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Cmek_config_service.update_cmek_config | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/cmek_config_service.update_cmek_config.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/cmek_config_service.update_cmek_config.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Completion_service.complete_query | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/completion_service.complete_query.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/completion_service.complete_query.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Completion_service.import_completion_suggestions | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/completion_service.import_completion_suggestions.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/completion_service.import_completion_suggestions.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Completion_service.import_suggestion_deny_list_entries | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/completion_service.import_suggestion_deny_list_entries.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/completion_service.import_suggestion_deny_list_entries.js,packages/google-cloud-discoveryengine/samples/README.md) |
@@ -170,6 +174,13 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Grounded_generation_service.check_grounding | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/grounded_generation_service.check_grounding.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/grounded_generation_service.check_grounding.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Grounded_generation_service.generate_grounded_content | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/grounded_generation_service.generate_grounded_content.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/grounded_generation_service.generate_grounded_content.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Grounded_generation_service.stream_generate_grounded_content | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/grounded_generation_service.stream_generate_grounded_content.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/grounded_generation_service.stream_generate_grounded_content.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Identity_mapping_store_service.create_identity_mapping_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.create_identity_mapping_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.create_identity_mapping_store.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Identity_mapping_store_service.delete_identity_mapping_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.delete_identity_mapping_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.delete_identity_mapping_store.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Identity_mapping_store_service.get_identity_mapping_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.get_identity_mapping_store.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.get_identity_mapping_store.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Identity_mapping_store_service.import_identity_mappings | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.import_identity_mappings.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.import_identity_mappings.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Identity_mapping_store_service.list_identity_mapping_stores | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.list_identity_mapping_stores.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.list_identity_mapping_stores.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Identity_mapping_store_service.list_identity_mappings | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.list_identity_mappings.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.list_identity_mappings.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Identity_mapping_store_service.purge_identity_mappings | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.purge_identity_mappings.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/identity_mapping_store_service.purge_identity_mappings.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Project_service.provision_project | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/project_service.provision_project.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/project_service.provision_project.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Rank_service.rank | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/rank_service.rank.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/rank_service.rank.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Recommendation_service.recommend | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/recommendation_service.recommend.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/recommendation_service.recommend.js,packages/google-cloud-discoveryengine/samples/README.md) |
@@ -202,6 +213,8 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | User_event_service.import_user_events | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/user_event_service.import_user_events.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/user_event_service.import_user_events.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | User_event_service.purge_user_events | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/user_event_service.purge_user_events.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/user_event_service.purge_user_events.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | User_event_service.write_user_event | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/user_event_service.write_user_event.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/user_event_service.write_user_event.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| User_license_service.batch_update_user_licenses | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/user_license_service.batch_update_user_licenses.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/user_license_service.batch_update_user_licenses.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| User_license_service.list_user_licenses | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/user_license_service.list_user_licenses.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1/user_license_service.list_user_licenses.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Acl_config_service.get_acl_config | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/acl_config_service.get_acl_config.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1alpha/acl_config_service.get_acl_config.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Acl_config_service.update_acl_config | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/acl_config_service.update_acl_config.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1alpha/acl_config_service.update_acl_config.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Chunk_service.get_chunk | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/chunk_service.get_chunk.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-discoveryengine/samples/generated/v1alpha/chunk_service.get_chunk.js,packages/google-cloud-discoveryengine/samples/README.md) |

package/build/protos/google/cloud/discoveryengine/v1/answer.proto

@@ -325,6 +325,9 @@ message Answer {
 
         // Non-answer-seeking query classification type, for no clear intent.
         NON_ANSWER_SEEKING_QUERY_V2 = 4;
+
+        // User defined query classification type.
+        USER_DEFINED_CLASSIFICATION_QUERY = 5;
       }
 
       // Query classification type.
@@ -409,6 +412,20 @@ message Answer {
     // Google skips the answer if a well grounded answer was unable to be
     // generated.
     LOW_GROUNDED_ANSWER = 9;
+
+    // The user defined query classification ignored case.
+    //
+    // Google skips the answer if the query is classified as a user defined
+    // query classification.
+    USER_DEFINED_CLASSIFICATION_QUERY_IGNORED = 10;
+
+    // The unhelpful answer case.
+    //
+    // Google skips the answer if the answer is not helpful. This can be due to
+    // a variety of factors, including but not limited to: the query is not
+    // answerable, the answer is not relevant to the query, or the answer is
+    // not well-formatted.
+    UNHELPFUL_ANSWER = 11;
   }
 
   // Immutable. Fully qualified name

package/build/protos/google/cloud/discoveryengine/v1/chunk.proto

@@ -82,6 +82,42 @@ message Chunk {
     repeated Chunk next_chunks = 2;
   }
 
+  // The structured content information.
+  message StructuredContent {
+    // Output only. The structure type of the structured content.
+    StructureType structure_type = 1
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The content of the structured content.
+    string content = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // The annotation metadata includes structured content in the current chunk.
+  message AnnotationMetadata {
+    // Output only. The structured content information.
+    StructuredContent structured_content = 1
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Image id is provided if the structured content is based on
+    // an image.
+    string image_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Defines the types of the structured content that can be extracted.
+  enum StructureType {
+    // Default value.
+    STRUCTURE_TYPE_UNSPECIFIED = 0;
+
+    // Shareholder structure.
+    SHAREHOLDER_STRUCTURE = 1;
+
+    // Signature structure.
+    SIGNATURE_STRUCTURE = 2;
+
+    // Checkbox structure.
+    CHECKBOX_STRUCTURE = 3;
+  }
+
   // The full resource name of the chunk.
   // Format:
   // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document_id}/chunks/{chunk_id}`.
@@ -117,4 +153,20 @@ message Chunk {
 
   // Output only. Metadata of the current chunk.
   ChunkMetadata chunk_metadata = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Image Data URLs if the current chunk contains images.
+  // Data URLs are composed of four parts: a prefix (data:), a MIME type
+  // indicating the type of data, an optional base64 token if non-textual,
+  // and the data itself:
+  // data:[<mediatype>][;base64],<data>
+  repeated string data_urls = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Annotation contents if the current chunk contains annotations.
+  repeated string annotation_contents = 11
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The annotation metadata includes structured content in the
+  // current chunk.
+  repeated AnnotationMetadata annotation_metadata = 12
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }

package/build/protos/google/cloud/discoveryengine/v1/cmek_config_service.proto

@@ -0,0 +1,300 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.discoveryengine.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1/discoveryenginepb;discoveryenginepb";
+option java_multiple_files = true;
+option java_outer_classname = "CmekConfigServiceProto";
+option java_package = "com.google.cloud.discoveryengine.v1";
+option objc_class_prefix = "DISCOVERYENGINE";
+option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1";
+option ruby_package = "Google::Cloud::DiscoveryEngine::V1";
+
+// Service for managing CMEK related tasks
+service CmekConfigService {
+  option (google.api.default_host) = "discoveryengine.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Provisions a CMEK key for use in a location of a customer's project.
+  // This method will also conduct location validation on the provided
+  // cmekConfig to make sure the key is valid and can be used in the
+  // selected location.
+  rpc UpdateCmekConfig(UpdateCmekConfigRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1/{config.name=projects/*/locations/*/cmekConfig}"
+      body: "config"
+      additional_bindings {
+        patch: "/v1/{config.name=projects/*/locations/*/cmekConfigs/*}"
+        body: "config"
+      }
+    };
+    option (google.api.method_signature) = "config";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.discoveryengine.v1.CmekConfig"
+      metadata_type: "google.cloud.discoveryengine.v1.UpdateCmekConfigMetadata"
+    };
+  }
+
+  // Gets the [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig].
+  rpc GetCmekConfig(GetCmekConfigRequest) returns (CmekConfig) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/cmekConfig}"
+      additional_bindings {
+        get: "/v1/{name=projects/*/locations/*/cmekConfigs/*}"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists all the [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]s
+  // with the project.
+  rpc ListCmekConfigs(ListCmekConfigsRequest)
+      returns (ListCmekConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/cmekConfigs"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // De-provisions a CmekConfig.
+  rpc DeleteCmekConfig(DeleteCmekConfigRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/cmekConfigs/*}"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "google.cloud.discoveryengine.v1.DeleteCmekConfigMetadata"
+    };
+  }
+}
+
+// Request message for UpdateCmekConfig method.
+// rpc.
+message UpdateCmekConfigRequest {
+  // Required. The CmekConfig resource.
+  CmekConfig config = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Set the following CmekConfig as the default to be used for child
+  // resources if one is not specified.
+  bool set_default = 2;
+}
+
+// Request message for GetCmekConfigRequest method.
+message GetCmekConfigRequest {
+  // Required. Resource name of
+  // [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig], such as
+  // `projects/*/locations/*/cmekConfig` or
+  // `projects/*/locations/*/cmekConfigs/*`.
+  //
+  // If the caller does not have permission to access the
+  // [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig], regardless of
+  // whether or not it exists, a PERMISSION_DENIED error is returned.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/CmekConfig"
+    }
+  ];
+}
+
+// Metadata for single-regional CMEKs.
+message SingleRegionKey {
+  // Required. Single-regional kms key resource name which will be used to
+  // encrypt resources
+  // `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  string kms_key = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKeys"
+    }
+  ];
+}
+
+// Configurations used to enable CMEK data encryption with Cloud KMS keys.
+message CmekConfig {
+  option (google.api.resource) = {
+    type: "discoveryengine.googleapis.com/CmekConfig"
+    pattern: "projects/{project}/locations/{location}/cmekConfig"
+    pattern: "projects/{project}/locations/{location}/cmekConfigs/{cmek_config}"
+    plural: "cmekConfigs"
+    singular: "cmekConfig"
+  };
+
+  // States of the CmekConfig.
+  enum State {
+    // The CmekConfig state is unknown.
+    STATE_UNSPECIFIED = 0;
+
+    // The CmekConfig is creating.
+    CREATING = 1;
+
+    // The CmekConfig can be used with DataStores.
+    ACTIVE = 2;
+
+    // The CmekConfig is unavailable, most likely due to the KMS Key being
+    // revoked.
+    KEY_ISSUE = 3;
+
+    // The CmekConfig is deleting.
+    DELETING = 4;
+
+    // The CmekConfig deletion process failed.
+    DELETE_FAILED = 7;
+
+    // The CmekConfig is not usable, most likely due to some internal issue.
+    UNUSABLE = 5;
+
+    // The KMS key version is being rotated.
+    ACTIVE_ROTATING = 6;
+
+    // The KMS key is soft deleted. Some cleanup policy will eventually be
+    // applied.
+    DELETED = 8;
+  }
+
+  // States of NotebookLM.
+  enum NotebookLMState {
+    // The NotebookLM state is unknown.
+    NOTEBOOK_LM_STATE_UNSPECIFIED = 0;
+
+    // The NotebookLM is not ready.
+    NOTEBOOK_LM_NOT_READY = 1;
+
+    // The NotebookLM is ready to be used.
+    NOTEBOOK_LM_READY = 2;
+
+    // The NotebookLM is not enabled.
+    NOTEBOOK_LM_NOT_ENABLED = 3;
+  }
+
+  // Required. The name of the CmekConfig of the form
+  // `projects/{project}/locations/{location}/cmekConfig` or
+  // `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // KMS key resource name which will be used to encrypt resources
+  // `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  string kms_key = 2 [(google.api.resource_reference) = {
+    type: "cloudkms.googleapis.com/CryptoKeys"
+  }];
+
+  // KMS key version resource name which will be used to encrypt resources
+  // `<kms_key>/cryptoKeyVersions/{keyVersion}`.
+  string kms_key_version = 6 [(google.api.resource_reference) = {
+    type: "cloudkms.googleapis.com/CryptoKeyVersions"
+  }];
+
+  // Output only. The states of the CmekConfig.
+  State state = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The default CmekConfig for the Customer.
+  bool is_default = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The timestamp of the last key rotation.
+  int64 last_rotation_timestamp_micros = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. Single-regional CMEKs that are required for some VAIS features.
+  repeated SingleRegionKey single_region_keys = 7
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. Whether the NotebookLM Corpus is ready to be used.
+  NotebookLMState notebooklm_state = 8
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Metadata related to the progress of the
+// [CmekConfigService.UpdateCmekConfig][google.cloud.discoveryengine.v1.CmekConfigService.UpdateCmekConfig]
+// operation. This will be returned by the google.longrunning.Operation.metadata
+// field.
+message UpdateCmekConfigMetadata {
+  // Operation create time.
+  google.protobuf.Timestamp create_time = 1;
+
+  // Operation last update time. If the operation is done, this is also the
+  // finish time.
+  google.protobuf.Timestamp update_time = 2;
+}
+
+// Request message for
+// [CmekConfigService.ListCmekConfigs][google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs]
+// method.
+message ListCmekConfigsRequest {
+  // Required. The parent location resource name, such as
+  // `projects/{project}/locations/{location}`.
+  //
+  // If the caller does not have permission to list
+  // [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]s under this
+  // location, regardless of whether or not a CmekConfig exists, a
+  // PERMISSION_DENIED error is returned.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/Location"
+    }
+  ];
+}
+
+// Response message for
+// [CmekConfigService.ListCmekConfigs][google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs]
+// method.
+message ListCmekConfigsResponse {
+  // All the customer's
+  // [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]s.
+  repeated CmekConfig cmek_configs = 1;
+}
+
+// Request message for
+// [CmekConfigService.DeleteCmekConfig][google.cloud.discoveryengine.v1.CmekConfigService.DeleteCmekConfig]
+// method.
+message DeleteCmekConfigRequest {
+  // Required. The resource name of the
+  // [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig] to delete, such as
+  // `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/CmekConfig"
+    }
+  ];
+}
+
+// Metadata related to the progress of the
+// [CmekConfigService.DeleteCmekConfig][google.cloud.discoveryengine.v1.CmekConfigService.DeleteCmekConfig]
+// operation. This will be returned by the google.longrunning.Operation.metadata
+// field.
+message DeleteCmekConfigMetadata {
+  // Operation create time.
+  google.protobuf.Timestamp create_time = 1;
+
+  // Operation last update time. If the operation is done, this is also the
+  // finish time.
+  google.protobuf.Timestamp update_time = 2;
+}

package/build/protos/google/cloud/discoveryengine/v1/common.proto

@@ -48,6 +48,14 @@ option (google.api.resource_definition) = {
   type: "discoveryengine.googleapis.com/RankingConfig"
   pattern: "projects/{project}/locations/{location}/rankingConfigs/{ranking_config}"
 };
+option (google.api.resource_definition) = {
+  type: "discoveryengine.googleapis.com/LicenseConfig"
+  pattern: "projects/{project}/locations/{location}/licenseConfigs/{license_config}"
+};
+option (google.api.resource_definition) = {
+  type: "discoveryengine.googleapis.com/UserStore"
+  pattern: "projects/{project}/locations/{location}/userStores/{user_store}"
+};
 option (google.api.resource_definition) = {
   type: "healthcare.googleapis.com/FhirStore"
   pattern: "projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}"
@@ -56,6 +64,14 @@ option (google.api.resource_definition) = {
   type: "healthcare.googleapis.com/FhirResource"
   pattern: "projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}/fhir/{resource_type}/{fhir_resource_id}"
 };
+option (google.api.resource_definition) = {
+  type: "cloudkms.googleapis.com/CryptoKeys"
+  pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}"
+};
+option (google.api.resource_definition) = {
+  type: "cloudkms.googleapis.com/CryptoKeyVersions"
+  pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}"
+};
 
 // The industry vertical associated with the
 // [DataStore][google.cloud.discoveryengine.v1.DataStore].
@@ -226,6 +242,47 @@ message DoubleList {
   repeated double values = 1;
 }
 
+// Principal identifier of a user or a group.
+message Principal {
+  // Union field principal. Principal can be a user or a group.
+  oneof principal {
+    // User identifier.
+    // For Google Workspace user account, user_id should be the google workspace
+    // user email.
+    // For non-google identity provider user account, user_id is the mapped user
+    // identifier configured during the workforcepool config.
+    string user_id = 1;
+
+    // Group identifier.
+    // For Google Workspace user account, group_id should be the google
+    // workspace group email.
+    // For non-google identity provider user account, group_id is the mapped
+    // group identifier configured during the workforcepool config.
+    string group_id = 2;
+
+    // For 3P application identities which are not present in the customer
+    // identity provider.
+    string external_entity_id = 3;
+  }
+}
+
+// Config to data store for `HEALTHCARE_FHIR` vertical.
+message HealthcareFhirConfig {
+  // Whether to enable configurable schema for `HEALTHCARE_FHIR` vertical.
+  //
+  // If set to `true`, the predefined healthcare fhir schema can be extended
+  // for more customized searching and filtering.
+  bool enable_configurable_schema = 1;
+
+  // Whether to enable static indexing for `HEALTHCARE_FHIR` batch
+  // ingestion.
+  //
+  // If set to `true`, the batch ingestion will be processed in a static
+  // indexing mode which is slower but more capable of handling larger
+  // volume.
+  bool enable_static_indexing_for_batch_ingestion = 2;
+}
+
 // Promotion proto includes uri and other helping information to display the
 // promotion.
 message SearchLinkPromotion {
@@ -237,6 +294,16 @@ message SearchLinkPromotion {
   // site search. For other verticals, this is optional.
   string uri = 2 [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. The [Document][google.cloud.discoveryengine.v1.Document] the user
+  // wants to promote. For site search, leave unset and only populate uri. Can
+  // be set along with uri.
+  string document = 6 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/Document"
+    }
+  ];
+
   // Optional. The promotion thumbnail image url.
   string image_uri = 3 [(google.api.field_behavior) = OPTIONAL];
 

package/build/protos/google/cloud/discoveryengine/v1/control.proto

@@ -77,7 +77,7 @@ message Condition {
   // Optional. Query regex to match the whole search query.
   // Cannot be set when
   // [Condition.query_terms][google.cloud.discoveryengine.v1.Condition.query_terms]
-  // is set. This is currently supporting promotion use case.
+  // is set. Only supported for Basic Site Search promotion serving controls.
   string query_regex = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -288,8 +288,6 @@ message Control {
     SynonymsAction synonyms_action = 10;
 
     // Promote certain links based on predefined trigger queries.
-    //
-    // This now only supports basic site search.
     PromoteAction promote_action = 15;
   }
 

package/build/protos/google/cloud/discoveryengine/v1/conversational_search_service.proto

@@ -833,6 +833,9 @@ message AnswerQueryRequest {
 
         // Non-answer-seeking query classification type, for no clear intent.
         NON_ANSWER_SEEKING_QUERY_V2 = 4;
+
+        // User defined query classification type.
+        USER_DEFINED_CLASSIFICATION_QUERY = 5;
       }
 
       // Enabled query classification types.