@google-cloud/discoveryengine 1.13.0 → 1.14.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.14.0](https://github.com/googleapis/google-cloud-node/compare/discoveryengine-v1.13.0...discoveryengine-v1.14.0) (2024-09-10)
+
+
+### Features
+
+* [discoveryengine] promote search tuning service to v1 ([#5655](https://github.com/googleapis/google-cloud-node/issues/5655)) ([f4072a0](https://github.com/googleapis/google-cloud-node/commit/f4072a051e85b1fd42116416f19e850bb32fc542))
+
 ## [1.13.0](https://github.com/googleapis/google-cloud-node/compare/discoveryengine-v1.12.0...discoveryengine-v1.13.0) (2024-08-19)
 
 

package/README.md

@@ -153,6 +153,7 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Data_store_service.get_data_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/data_store_service.get_data_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/data_store_service.get_data_store.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Data_store_service.list_data_stores | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/data_store_service.list_data_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/data_store_service.list_data_stores.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Data_store_service.update_data_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/data_store_service.update_data_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/data_store_service.update_data_store.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Document_service.batch_get_documents_metadata | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/document_service.batch_get_documents_metadata.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/document_service.batch_get_documents_metadata.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Document_service.create_document | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/document_service.create_document.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/document_service.create_document.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Document_service.delete_document | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/document_service.delete_document.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/document_service.delete_document.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Document_service.get_document | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/document_service.get_document.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/document_service.get_document.js,packages/google-cloud-discoveryengine/samples/README.md) |
@@ -175,6 +176,8 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Schema_service.list_schemas | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/schema_service.list_schemas.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/schema_service.list_schemas.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Schema_service.update_schema | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/schema_service.update_schema.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/schema_service.update_schema.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Search_service.search | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/search_service.search.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/search_service.search.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Search_tuning_service.list_custom_models | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/search_tuning_service.list_custom_models.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/search_tuning_service.list_custom_models.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Search_tuning_service.train_custom_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/search_tuning_service.train_custom_model.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/search_tuning_service.train_custom_model.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.batch_create_target_sites | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.batch_create_target_sites.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/site_search_engine_service.batch_create_target_sites.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.batch_verify_target_sites | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.batch_verify_target_sites.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/site_search_engine_service.batch_verify_target_sites.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Site_search_engine_service.create_target_site | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.create_target_site.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/site_search_engine_service.create_target_site.js,packages/google-cloud-discoveryengine/samples/README.md) |
@@ -189,6 +192,7 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Site_search_engine_service.update_target_site | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/site_search_engine_service.update_target_site.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/site_search_engine_service.update_target_site.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | User_event_service.collect_user_event | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1/user_event_service.collect_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.collect_user_event.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | 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) |
 | 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) |
@@ -224,6 +228,7 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Data_store_service.list_data_stores | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/data_store_service.list_data_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/v1alpha/data_store_service.list_data_stores.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Data_store_service.update_data_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/data_store_service.update_data_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/v1alpha/data_store_service.update_data_store.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Data_store_service.update_document_processing_config | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/data_store_service.update_document_processing_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/data_store_service.update_document_processing_config.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Document_service.batch_get_documents_metadata | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/document_service.batch_get_documents_metadata.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/document_service.batch_get_documents_metadata.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Document_service.create_document | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/document_service.create_document.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/document_service.create_document.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Document_service.delete_document | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/document_service.delete_document.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/document_service.delete_document.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Document_service.get_document | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1alpha/document_service.get_document.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/document_service.get_document.js,packages/google-cloud-discoveryengine/samples/README.md) |
@@ -319,6 +324,7 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Data_store_service.get_data_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1beta/data_store_service.get_data_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/v1beta/data_store_service.get_data_store.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Data_store_service.list_data_stores | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1beta/data_store_service.list_data_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/v1beta/data_store_service.list_data_stores.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Data_store_service.update_data_store | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1beta/data_store_service.update_data_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/v1beta/data_store_service.update_data_store.js,packages/google-cloud-discoveryengine/samples/README.md) |
+| Document_service.batch_get_documents_metadata | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1beta/document_service.batch_get_documents_metadata.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/v1beta/document_service.batch_get_documents_metadata.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Document_service.create_document | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1beta/document_service.create_document.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/v1beta/document_service.create_document.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Document_service.delete_document | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1beta/document_service.delete_document.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/v1beta/document_service.delete_document.js,packages/google-cloud-discoveryengine/samples/README.md) |
 | Document_service.get_document | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-discoveryengine/samples/generated/v1beta/document_service.get_document.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/v1beta/document_service.get_document.js,packages/google-cloud-discoveryengine/samples/README.md) |

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

@@ -69,6 +69,13 @@ message Answer {
 
         // Page identifier.
         string page_identifier = 2;
+
+        // The relevance of the chunk for a given query. Values range from 0.0
+        // (completely irrelevant) to 1.0 (completely relevant).
+        // This value is for informational purpose only. It may change for
+        // the same query and chunk at any time due to a model retraining or
+        // change in implementation.
+        optional float relevance_score = 3;
       }
 
       // Document resource name.
@@ -121,13 +128,28 @@ message Answer {
       // Chunk textual content.
       string content = 2;
 
-      // Relevance score.
+      // The relevance of the chunk for a given query. Values range from 0.0
+      // (completely irrelevant) to 1.0 (completely relevant).
+      // This value is for informational purpose only. It may change for
+      // the same query and chunk at any time due to a model retraining or
+      // change in implementation.
       optional float relevance_score = 3;
 
       // Document metadata.
       DocumentMetadata document_metadata = 4;
     }
 
+    // Structured search information.
+    message StructuredDocumentInfo {
+      // Document resource name.
+      string document = 1 [(google.api.resource_reference) = {
+        type: "discoveryengine.googleapis.com/Document"
+      }];
+
+      // Structured search data.
+      google.protobuf.Struct struct_data = 2;
+    }
+
     // Search result content.
     oneof content {
       // Unstructured document information.
@@ -135,6 +157,9 @@ message Answer {
 
       // Chunk information.
       ChunkInfo chunk_info = 2;
+
+      // Structured document information.
+      StructuredDocumentInfo structured_document_info = 3;
     }
   }
 
@@ -168,7 +193,11 @@ message Answer {
             // Chunk textual content.
             string content = 2;
 
-            // Relevance score.
+            // The relevance of the chunk for a given query. Values range from
+            // 0.0 (completely irrelevant) to 1.0 (completely relevant).
+            // This value is for informational purpose only. It may change for
+            // the same query and chunk at any time due to a model retraining or
+            // change in implementation.
             optional float relevance_score = 3;
           }
 
@@ -191,9 +220,8 @@ message Answer {
 
           // Data representation.
           // The structured JSON data for the document.
-          // It's populated from the struct data from the Document (code
-          // pointer: http://shortn/_objzAfIiHq), or the Chunk in search result
-          // (code pointer: http://shortn/_Ipo6KFFGBL).
+          // It's populated from the struct data from the Document, or the
+          // Chunk in search result.
           google.protobuf.Struct struct_data = 6;
         }
 
@@ -254,6 +282,9 @@ message Answer {
 
         // Non-answer-seeking query classification type.
         NON_ANSWER_SEEKING_QUERY = 2;
+
+        // Jail-breaking query classification type.
+        JAIL_BREAKING_QUERY = 3;
       }
 
       // Query classification type.
@@ -309,6 +340,19 @@ message Answer {
     // Google skips the answer if there is no relevant content in the
     // retrieved search results.
     NO_RELEVANT_CONTENT = 5;
+
+    // The jail-breaking query ignored case.
+    //
+    // For example, "Reply in the tone of a competing company's CEO".
+    // Google skips the answer if the query is classified as a jail-breaking
+    // query.
+    JAIL_BREAKING_QUERY_IGNORED = 6;
+
+    // The customer policy violation case.
+    //
+    // Google skips the summary if there is a customer policy violation
+    // detected. The policy is defined by the customer.
+    CUSTOMER_POLICY_VIOLATION = 7;
   }
 
   // Immutable. Fully qualified name

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

@@ -73,8 +73,9 @@ message Condition {
 }
 
 // Defines a conditioned behavior to employ during serving.
-// Must be attached to a [ServingConfig][] to be considered at serving time.
-// Permitted actions dependent on `SolutionType`.
+// Must be attached to a
+// [ServingConfig][google.cloud.discoveryengine.v1.ServingConfig] to be
+// considered at serving time. Permitted actions dependent on `SolutionType`.
 message Control {
   option (google.api.resource) = {
     type: "discoveryengine.googleapis.com/Control"
@@ -182,8 +183,9 @@ message Control {
   // Otherwise an INVALID ARGUMENT error is thrown.
   string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Output only. List of all [ServingConfig][] ids this control is attached to.
-  // May take up to 10 minutes to update after changes.
+  // Output only. List of all
+  // [ServingConfig][google.cloud.discoveryengine.v1.ServingConfig] IDs this
+  // control is attached to. May take up to 10 minutes to update after changes.
   repeated string associated_serving_config_ids = 3
       [(google.api.field_behavior) = OUTPUT_ONLY];
 

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

@@ -584,12 +584,7 @@ message AnswerQueryRequest {
       string order_by = 4;
 
       // Specifies the search result mode. If unspecified, the
-      // search result mode is based on
-      // [DataStore.DocumentProcessingConfig.chunking_config][]:
-      // * If [DataStore.DocumentProcessingConfig.chunking_config][] is
-      // specified,
-      //   it defaults to `CHUNKS`.
-      // * Otherwise, it defaults to `DOCUMENTS`.
+      // search result mode defaults to `DOCUMENTS`.
       // See [parse and chunk
       // documents](https://cloud.google.com/generative-ai-app-builder/docs/parse-chunk-documents)
       SearchRequest.ContentSearchSpec.SearchResultMode search_result_mode = 5;
@@ -707,6 +702,9 @@ message AnswerQueryRequest {
 
         // Non-answer-seeking query classification type.
         NON_ANSWER_SEEKING_QUERY = 2;
+
+        // Jail-breaking query classification type.
+        JAIL_BREAKING_QUERY = 3;
       }
 
       // Enabled query classification types.
@@ -819,9 +817,11 @@ message AnswerQueryRequest {
 // method.
 message AnswerQueryResponse {
   // Answer resource object.
-  // If [AnswerQueryRequest.StepSpec.max_step_count][] is greater than 1,
-  // use [Answer.name][google.cloud.discoveryengine.v1.Answer.name] to fetch
-  // answer information using
+  // If
+  // [AnswerQueryRequest.QueryUnderstandingSpec.QueryRephraserSpec.max_rephrase_steps][google.cloud.discoveryengine.v1.AnswerQueryRequest.QueryUnderstandingSpec.QueryRephraserSpec.max_rephrase_steps]
+  // is greater than 1, use
+  // [Answer.name][google.cloud.discoveryengine.v1.Answer.name] to fetch answer
+  // information using
   // [ConversationalSearchService.GetAnswer][google.cloud.discoveryengine.v1.ConversationalSearchService.GetAnswer]
   // API.
   Answer answer = 1;

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

@@ -0,0 +1,96 @@
+// Copyright 2024 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/field_behavior.proto";
+import "google/api/resource.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 = "CustomTuningModelProto";
+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";
+
+// Metadata that describes a custom tuned model.
+message CustomTuningModel {
+  option (google.api.resource) = {
+    type: "discoveryengine.googleapis.com/CustomTuningModel"
+    pattern: "projects/{project}/locations/{location}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}"
+    pattern: "projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}"
+  };
+
+  // The state of the model.
+  enum ModelState {
+    // Default value.
+    MODEL_STATE_UNSPECIFIED = 0;
+
+    // The model is in a paused training state.
+    TRAINING_PAUSED = 1;
+
+    // The model is currently training.
+    TRAINING = 2;
+
+    // The model has successfully completed training.
+    TRAINING_COMPLETE = 3;
+
+    // The model is ready for serving.
+    READY_FOR_SERVING = 4;
+
+    // The model training failed.
+    TRAINING_FAILED = 5;
+
+    // The model training finished successfully but metrics did not improve.
+    NO_IMPROVEMENT = 6;
+
+    // Input data validation failed. Model training didn't start.
+    INPUT_VALIDATION_FAILED = 7;
+  }
+
+  // Required. The fully qualified resource name of the model.
+  //
+  // Format:
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`
+  // model must be an alpha-numerical string with limit of 40 characters.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/CustomTuningModel"
+    }
+  ];
+
+  // The display name of the model.
+  string display_name = 2;
+
+  // The version of the model.
+  int64 model_version = 3;
+
+  // The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`).
+  ModelState model_state = 4;
+
+  // Deprecated: timestamp the Model was created at.
+  google.protobuf.Timestamp create_time = 5 [deprecated = true];
+
+  // Timestamp the model training was initiated.
+  google.protobuf.Timestamp training_start_time = 6;
+
+  // The metrics of the trained model.
+  map<string, double> metrics = 7;
+}

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

@@ -152,6 +152,16 @@ message CreateDataStoreRequest {
   // search (GENERIC vertical and PUBLIC_WEBSITE content_config), this flag will
   // be ignored.
   bool create_advanced_site_search = 4;
+
+  // A boolean flag indicating whether to skip the default schema creation for
+  // the data store. Only enable this flag if you are certain that the default
+  // schema is incompatible with your use case.
+  //
+  // If set to true, you must manually create a schema for the data store before
+  // any documents can be ingested.
+  //
+  // This flag cannot be specified if `data_store.starting_schema` is specified.
+  bool skip_default_schema_creation = 7;
 }
 
 // Request message for

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

@@ -20,6 +20,7 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1";
 option go_package = "cloud.google.com/go/discoveryengine/apiv1/discoveryenginepb;discoveryenginepb";
@@ -70,6 +71,17 @@ message Document {
     string mime_type = 1;
   }
 
+  // Index status of the document.
+  message IndexStatus {
+    // The time when the document was indexed.
+    // If this field is populated, it means the document has been indexed.
+    google.protobuf.Timestamp index_time = 1;
+
+    // A sample of errors encountered while indexing the document.
+    // If this field is populated, the document is not indexed due to errors.
+    repeated google.rpc.Status error_samples = 2;
+  }
+
   // Data representation. One of
   // [struct_data][google.cloud.discoveryengine.v1.Document.struct_data] or
   // [json_data][google.cloud.discoveryengine.v1.Document.json_data] should be
@@ -127,4 +139,12 @@ message Document {
   // document has never been indexed.
   google.protobuf.Timestamp index_time = 13
       [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The index status of the document.
+  //
+  // * If document is indexed successfully, the index_time field is populated.
+  // * Otherwise, if document is not indexed due to errors, the error_samples
+  //   field is populated.
+  // * Otherwise, index_status is unset.
+  IndexStatus index_status = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
 }

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

@@ -123,5 +123,7 @@ message DocumentProcessingConfig {
   // layout parsing are supported.
   // * `pptx`: Override parsing config for PPTX files, only digital parsing and
   // layout parsing are supported.
+  // * `xlsx`: Override parsing config for XLSX files, only digital parsing and
+  // layout parsing are supported.
   map<string, ParsingConfig> parsing_config_overrides = 5;
 }

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

@@ -26,6 +26,7 @@ import "google/cloud/discoveryengine/v1/purge_config.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1";
 option go_package = "cloud.google.com/go/discoveryengine/apiv1/discoveryenginepb;discoveryenginepb";
@@ -156,6 +157,20 @@ service DocumentService {
       metadata_type: "google.cloud.discoveryengine.v1.PurgeDocumentsMetadata"
     };
   }
+
+  // Gets index freshness metadata for
+  // [Document][google.cloud.discoveryengine.v1.Document]s. Supported for
+  // website search only.
+  rpc BatchGetDocumentsMetadata(BatchGetDocumentsMetadataRequest)
+      returns (BatchGetDocumentsMetadataResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/dataStores/*/branches/*}/batchGetDocumentsMetadata"
+      additional_bindings {
+        get: "/v1/{parent=projects/*/locations/*/collections/*/dataStores/*/branches/*}/batchGetDocumentsMetadata"
+      }
+    };
+    option (google.api.method_signature) = "parent";
+  }
 }
 
 // Request message for
@@ -318,3 +333,98 @@ message DeleteDocumentRequest {
     }
   ];
 }
+
+// Request message for
+// [DocumentService.BatchGetDocumentsMetadata][google.cloud.discoveryengine.v1.DocumentService.BatchGetDocumentsMetadata]
+// method.
+message BatchGetDocumentsMetadataRequest {
+  // Matcher for the [Document][google.cloud.discoveryengine.v1.Document]s by
+  // exact uris.
+  message UrisMatcher {
+    // The exact URIs to match by.
+    repeated string uris = 1;
+  }
+
+  // Matcher for the [Document][google.cloud.discoveryengine.v1.Document]s.
+  // Currently supports matching by exact URIs.
+  message Matcher {
+    // Matcher for the [Document][google.cloud.discoveryengine.v1.Document]s.
+    oneof matcher {
+      // Matcher by exact URIs.
+      UrisMatcher uris_matcher = 1;
+    }
+  }
+
+  // Required. The parent branch resource name, such as
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/Branch"
+    }
+  ];
+
+  // Required. Matcher for the
+  // [Document][google.cloud.discoveryengine.v1.Document]s.
+  Matcher matcher = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for
+// [DocumentService.BatchGetDocumentsMetadata][google.cloud.discoveryengine.v1.DocumentService.BatchGetDocumentsMetadata]
+// method.
+message BatchGetDocumentsMetadataResponse {
+  // The metadata of a [Document][google.cloud.discoveryengine.v1.Document].
+  message DocumentMetadata {
+    // The value of the matcher that was used to match the
+    // [Document][google.cloud.discoveryengine.v1.Document].
+    message MatcherValue {
+      // The value of the matcher that was used to match the
+      // [Document][google.cloud.discoveryengine.v1.Document].
+      oneof matcher_value {
+        // If match by URI, the URI of the
+        // [Document][google.cloud.discoveryengine.v1.Document].
+        string uri = 1;
+      }
+    }
+
+    // The value of the matcher that was used to match the
+    // [Document][google.cloud.discoveryengine.v1.Document].
+    MatcherValue matcher_value = 2;
+
+    // The state of the document.
+    State state = 3;
+
+    // The timestamp of the last time the
+    // [Document][google.cloud.discoveryengine.v1.Document] was last indexed.
+    google.protobuf.Timestamp last_refreshed_time = 4;
+
+    // The data ingestion source of the
+    // [Document][google.cloud.discoveryengine.v1.Document].
+    //
+    // Allowed values are:
+    //
+    // * `batch`: Data ingested via Batch API, e.g., ImportDocuments.
+    // * `streaming` Data ingested via Streaming API, e.g., FHIR streaming.
+    string data_ingestion_source = 5;
+  }
+
+  // The state of the [Document][google.cloud.discoveryengine.v1.Document].
+  enum State {
+    // Should never be set.
+    STATE_UNSPECIFIED = 0;
+
+    // The [Document][google.cloud.discoveryengine.v1.Document] is indexed.
+    INDEXED = 1;
+
+    // The [Document][google.cloud.discoveryengine.v1.Document] is not indexed
+    // because its URI is not in the
+    // [TargetSite][google.cloud.discoveryengine.v1.TargetSite].
+    NOT_IN_TARGET_SITE = 2;
+
+    // The [Document][google.cloud.discoveryengine.v1.Document] is not indexed.
+    NOT_IN_INDEX = 3;
+  }
+
+  // The metadata of the [Document][google.cloud.discoveryengine.v1.Document]s.
+  repeated DocumentMetadata documents_metadata = 1;
+}

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

@@ -129,8 +129,9 @@ message CheckGroundingResponse {
     // field will be set to false. In that case, no grounding check was done for
     // the claim and therefore
     // [citation_indices][google.cloud.discoveryengine.v1.CheckGroundingResponse.Claim.citation_indices],
+    // [anti_citation_indices][google.cloud.discoveryengine.v1.CheckGroundingResponse.Claim.anti_citation_indices],
     // and
-    // [anti_citation_indices][google.cloud.discoveryengine.v1.CheckGroundingResponse.Claim.anti_citation_indices]
+    // [score][google.cloud.discoveryengine.v1.CheckGroundingResponse.Claim.score]
     // should not be returned.
     optional bool grounding_check_required = 6;
   }

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

@@ -82,7 +82,7 @@ message BigQuerySource {
     google.type.Date partition_date = 5;
   }
 
-  // The project ID (can be project # or ID) that the BigQuery source is in with
+  // The project ID or the project number that contains the BigQuery source. Has
   // a length limit of 128 characters. If not specified, inherits the project
   // ID from the parent request.
   string project_id = 1;
@@ -124,7 +124,7 @@ message BigQuerySource {
 
 // The Spanner source for importing data
 message SpannerSource {
-  // The project ID that the Spanner source is in with a length limit of 128
+  // The project ID that contains the Spanner source. Has a length limit of 128
   // characters. If not specified, inherits the project ID from the parent
   // request.
   string project_id = 1;
@@ -258,7 +258,7 @@ message BigtableOptions {
 
 // The Cloud Bigtable source for importing data.
 message BigtableSource {
-  // The project ID that the Bigtable source is in with a length limit of 128
+  // The project ID that contains the Bigtable source. Has a length limit of 128
   // characters. If not specified, inherits the project ID from the parent
   // request.
   string project_id = 1;
@@ -290,12 +290,18 @@ message FhirStoreSource {
   // limit of 2,000 characters. Can be specified if one wants to have the
   // FhirStore export to a specific Cloud Storage directory.
   string gcs_staging_dir = 2;
+
+  // The FHIR resource types to import. The resource types should be a subset of
+  // all [supported FHIR resource
+  // types](https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification).
+  // Default to all supported FHIR resource types if empty.
+  repeated string resource_types = 3;
 }
 
 // Cloud SQL source import data from.
 message CloudSqlSource {
-  // The project ID that the Cloud SQL source is in with a length limit of 128
-  // characters. If not specified, inherits the project ID from the parent
+  // The project ID that contains the Cloud SQL source. Has a length limit of
+  // 128 characters. If not specified, inherits the project ID from the parent
   // request.
   string project_id = 1;
 
@@ -327,8 +333,8 @@ message CloudSqlSource {
 
 // AlloyDB source import data from.
 message AlloyDbSource {
-  // The project ID that the AlloyDB source is in
-  // with a length limit of 128 characters. If not specified, inherits the
+  // The project ID that contains the AlloyDB source.
+  // Has a length limit of 128 characters. If not specified, inherits the
   // project ID from the parent request.
   string project_id = 1;