@google-cloud/discoveryengine 1.7.0 → 1.9.0

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

@@ -0,0 +1,92 @@
+// 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";
+
+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 = "DocumentProcessingConfigProto";
+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";
+
+// A singleton resource of
+// [DataStore][google.cloud.discoveryengine.v1.DataStore]. It's empty when
+// [DataStore][google.cloud.discoveryengine.v1.DataStore] is created, which
+// defaults to digital parser. The first call to
+// [DataStoreService.UpdateDocumentProcessingConfig][] method will initialize
+// the config.
+message DocumentProcessingConfig {
+  option (google.api.resource) = {
+    type: "discoveryengine.googleapis.com/DocumentProcessingConfig"
+    pattern: "projects/{project}/locations/{location}/dataStores/{data_store}/documentProcessingConfig"
+    pattern: "projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/documentProcessingConfig"
+  };
+
+  // Related configurations applied to a specific type of document parser.
+  message ParsingConfig {
+    // The digital parsing configurations for documents.
+    message DigitalParsingConfig {}
+
+    // The OCR parsing configurations for documents.
+    message OcrParsingConfig {
+      // [DEPRECATED] This field is deprecated. To use the additional enhanced
+      // document elements processing, please switch to `layout_parsing_config`.
+      repeated string enhanced_document_elements = 1 [deprecated = true];
+
+      // If true, will use native text instead of OCR text on pages containing
+      // native text.
+      bool use_native_text = 2;
+    }
+
+    // Configs for document processing types.
+    oneof type_dedicated_config {
+      // Configurations applied to digital parser.
+      DigitalParsingConfig digital_parsing_config = 1;
+
+      // Configurations applied to OCR parser. Currently it only applies to
+      // PDFs.
+      OcrParsingConfig ocr_parsing_config = 2;
+    }
+  }
+
+  // The full resource name of the Document Processing Config.
+  // Format:
+  // `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
+  string name = 1;
+
+  // Configurations for default Document parser.
+  // If not specified, we will configure it as default DigitalParsingConfig, and
+  // the default parsing config will be applied to all file types for Document
+  // parsing.
+  ParsingConfig default_parsing_config = 4;
+
+  // Map from file type to override the default parsing configuration based on
+  // the file type. Supported keys:
+  //
+  // * `pdf`: Override parsing config for PDF files, either digital parsing, ocr
+  // parsing or layout parsing is supported.
+  // * `html`: Override parsing config for HTML files, only digital parsing and
+  // or layout parsing are supported.
+  // * `docx`: Override parsing config for DOCX files, only digital parsing and
+  // or layout parsing are supported.
+  map<string, ParsingConfig> parsing_config_overrides = 5;
+}

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

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// 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.
@@ -104,7 +104,7 @@ service DocumentService {
 
   // Bulk import of multiple
   // [Document][google.cloud.discoveryengine.v1.Document]s. Request processing
-  // may be synchronous. Non-existing items will be created.
+  // may be synchronous. Non-existing items are created.
   //
   // Note: It is possible for a subset of the
   // [Document][google.cloud.discoveryengine.v1.Document]s to be successfully
@@ -202,7 +202,7 @@ message ListDocumentsRequest {
 
   // Maximum number of [Document][google.cloud.discoveryengine.v1.Document]s to
   // return. If unspecified, defaults to 100. The maximum allowed value is 1000.
-  // Values above 1000 will be coerced to 1000.
+  // Values above 1000 are set to 1000.
   //
   // If this field is negative, an `INVALID_ARGUMENT` error is returned.
   int32 page_size = 2;
@@ -252,7 +252,7 @@ message CreateDocumentRequest {
   Document document = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The ID to use for the
-  // [Document][google.cloud.discoveryengine.v1.Document], which will become the
+  // [Document][google.cloud.discoveryengine.v1.Document], which becomes the
   // final component of the
   // [Document.name][google.cloud.discoveryengine.v1.Document.name].
   //
@@ -287,13 +287,13 @@ message UpdateDocumentRequest {
   // is not set, a `NOT_FOUND` error is returned.
   Document document = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // If set to true, and the
+  // If set to `true` and the
   // [Document][google.cloud.discoveryengine.v1.Document] is not found, a new
-  // [Document][google.cloud.discoveryengine.v1.Document] will be created.
+  // [Document][google.cloud.discoveryengine.v1.Document] is be created.
   bool allow_missing = 2;
 
   // Indicates which fields in the provided imported 'document' to update. If
-  // not set, will by default update all fields.
+  // not set, by default updates all fields.
   google.protobuf.FieldMask update_mask = 3;
 }
 

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

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// 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.
@@ -118,9 +118,9 @@ message Engine {
 
   // Common configurations for an Engine.
   message CommonConfig {
-    // Immutable. The name of the company, business or entity that is associated
-    // with the engine. Setting this may help improve LLM related features.
-    string company_name = 1 [(google.api.field_behavior) = IMMUTABLE];
+    // The name of the company, business or entity that is associated with the
+    // engine. Setting this may help improve LLM related features.
+    string company_name = 1;
   }
 
   // Additional information of a Chat Engine.
@@ -207,7 +207,7 @@ message Engine {
   // The restriction of the Engine industry vertical is based on
   // [DataStore][google.cloud.discoveryengine.v1.DataStore]: If unspecified,
   // default to `GENERIC`. Vertical on Engine has to match vertical of the
-  // DataStore liniked to the engine.
+  // DataStore linked to the engine.
   IndustryVertical industry_vertical = 16;
 
   // Common config spec that specifies the metadata of the engine.

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

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// 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.

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

@@ -0,0 +1,149 @@
+// 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/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/discoveryengine/v1/grounding.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 = "GroundedGenerationServiceProto";
+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 grounded generation.
+service GroundedGenerationService {
+  option (google.api.default_host) = "discoveryengine.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Performs a grounding check.
+  rpc CheckGrounding(CheckGroundingRequest) returns (CheckGroundingResponse) {
+    option (google.api.http) = {
+      post: "/v1/{grounding_config=projects/*/locations/*/groundingConfigs/*}:check"
+      body: "*"
+    };
+  }
+}
+
+// Specification for the grounding check.
+message CheckGroundingSpec {
+  // The threshold (in [0,1]) used for determining whether a fact must be
+  // cited for a claim in the answer candidate. Choosing a higher threshold
+  // will lead to fewer but very strong citations, while choosing a lower
+  // threshold may lead to more but somewhat weaker citations. If unset, the
+  // threshold will default to 0.6.
+  optional double citation_threshold = 1;
+}
+
+// Request message for
+// [GroundedGenerationService.CheckGrounding][google.cloud.discoveryengine.v1.GroundedGenerationService.CheckGrounding]
+// method.
+message CheckGroundingRequest {
+  // Required. The resource name of the grounding config, such as
+  // `projects/*/locations/global/groundingConfigs/default_grounding_config`.
+  string grounding_config = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/GroundingConfig"
+    }
+  ];
+
+  // Answer candidate to check. Can have a maximum length of 1024 characters.
+  string answer_candidate = 2;
+
+  // List of facts for the grounding check.
+  // We support up to 200 facts.
+  repeated GroundingFact facts = 3;
+
+  // Configuration of the grounding check.
+  CheckGroundingSpec grounding_spec = 4;
+
+  // The user labels applied to a resource must meet the following requirements:
+  //
+  // * Each resource can have multiple labels, up to a maximum of 64.
+  // * Each label must be a key-value pair.
+  // * Keys have a minimum length of 1 character and a maximum length of 63
+  //   characters and cannot be empty. Values can be empty and have a maximum
+  //   length of 63 characters.
+  // * Keys and values can contain only lowercase letters, numeric characters,
+  //   underscores, and dashes. All characters must use UTF-8 encoding, and
+  //   international characters are allowed.
+  // * The key portion of a label must be unique. However, you can use the same
+  //   key with multiple resources.
+  // * Keys must start with a lowercase letter or international character.
+  //
+  // See [Google Cloud
+  // Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+  // for more details.
+  map<string, string> user_labels = 5;
+}
+
+// Response message for the
+// [GroundedGenerationService.CheckGrounding][google.cloud.discoveryengine.v1.GroundedGenerationService.CheckGrounding]
+// method.
+message CheckGroundingResponse {
+  // Text and citation info for a claim in the answer candidate.
+  message Claim {
+    // Position indicating the start of the claim in the answer candidate,
+    // measured in bytes.
+    optional int32 start_pos = 1;
+
+    // Position indicating the end of the claim in the answer candidate,
+    // exclusive.
+    optional int32 end_pos = 2;
+
+    // Text for the claim in the answer candidate. Always provided regardless of
+    // whether citations or anti-citations are found.
+    string claim_text = 3;
+
+    // A list of indices (into 'cited_chunks') specifying the citations
+    // associated with the claim. For instance [1,3,4] means that
+    // cited_chunks[1], cited_chunks[3], cited_chunks[4] are the facts cited
+    // supporting for the claim. A citation to a fact indicates that the claim
+    // is supported by the fact.
+    repeated int32 citation_indices = 4;
+
+    // Indicates that this claim required grounding check. When the system
+    // decided this claim doesn't require attribution/grounding check, this
+    // 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],
+    // and
+    // [anti_citation_indices][google.cloud.discoveryengine.v1.CheckGroundingResponse.Claim.anti_citation_indices]
+    // should not be returned.
+    optional bool grounding_check_required = 6;
+  }
+
+  // The support score for the input answer candidate.
+  // Higher the score, higher is the fraction of claims that are supported by
+  // the provided facts. This is always set when a response is returned.
+  optional float support_score = 1;
+
+  // List of facts cited across all claims in the answer candidate.
+  // These are derived from the facts supplied in the request.
+  repeated FactChunk cited_chunks = 3;
+
+  // Claim texts and citation info across all claims in the answer candidate.
+  repeated Claim claims = 4;
+}

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

@@ -0,0 +1,58 @@
+// 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";
+
+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 = "GroundingProto";
+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";
+
+// Grounding Fact.
+message GroundingFact {
+  // Text content of the fact. Can be at most 10K characters long.
+  string fact_text = 1;
+
+  // Attributes associated with the fact.
+  // Common attributes include `source` (indicating where the fact was sourced
+  // from), `author` (indicating the author of the fact), and so on.
+  map<string, string> attributes = 2;
+}
+
+// Fact Chunk.
+message FactChunk {
+  // Text content of the fact chunk. Can be at most 10K characters long.
+  string chunk_text = 1;
+
+  // Source from which this fact chunk was retrieved. If it was retrieved
+  // from the GroundingFacts provided in the request then this field will
+  // contain the index of the specific fact from which this chunk was
+  // retrieved.
+  string source = 2;
+
+  // The index of this chunk. Currently, only used for the streaming mode.
+  int32 index = 4;
+
+  // More fine-grained information for the source reference.
+  map<string, string> source_metadata = 3;
+}

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

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// 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.
@@ -37,7 +37,7 @@ option ruby_package = "Google::Cloud::DiscoveryEngine::V1";
 
 // Cloud Storage location for input content.
 message GcsSource {
-  // Required. Cloud Storage URIs to input files. URI can be up to
+  // Required. Cloud Storage URIs to input files. Each URI can be up to
   // 2000 characters long. URIs can match the full object path (for example,
   // `gs://bucket/directory/object.json`) or a pattern matching one or more
   // files, such as `gs://bucket/directory/*.json`.
@@ -66,7 +66,7 @@ message GcsSource {
   //   data store. Each entry after the header is imported as a Document.
   //   This can only be used by the GENERIC Data Store vertical.
   //
-  // Supported values for user even imports:
+  // Supported values for user event imports:
   //
   // * `user_event` (default): One JSON
   // [UserEvent][google.cloud.discoveryengine.v1.UserEvent] per line.
@@ -336,8 +336,8 @@ message FirestoreSource {
   // of 256 characters.
   string database_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The Firestore collection to copy the data from with a length
-  // limit of 1,500 characters.
+  // Required. The Firestore collection (or entity) to copy the data from with a
+  // length limit of 1,500 characters.
   string collection_id = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Intermediate Cloud Storage directory used for the import with a length

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

@@ -0,0 +1,103 @@
+// 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 = "ProjectProto";
+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 and configurations for a Google Cloud project in the service.
+message Project {
+  option (google.api.resource) = {
+    type: "discoveryengine.googleapis.com/Project"
+    pattern: "projects/{project}"
+  };
+
+  // Metadata about the terms of service.
+  message ServiceTerms {
+    // The agreement states this terms of service.
+    enum State {
+      // The default value of the enum. This value is not actually used.
+      STATE_UNSPECIFIED = 0;
+
+      // The project has given consent to the terms of service.
+      TERMS_ACCEPTED = 1;
+
+      // The project is pending to review and accept the terms of service.
+      TERMS_PENDING = 2;
+
+      // The project has declined or revoked the agreement to terms of service.
+      TERMS_DECLINED = 3;
+    }
+
+    // The unique identifier of this terms of service.
+    // Available terms:
+    //
+    // * `GA_DATA_USE_TERMS`: [Terms for data
+    // use](https://cloud.google.com/retail/data-use-terms). When using this as
+    // `id`, the acceptable
+    // [version][google.cloud.discoveryengine.v1.Project.ServiceTerms.version]
+    // to provide is `2022-11-23`.
+    string id = 1;
+
+    // The version string of the terms of service.
+    // For acceptable values, see the comments for
+    // [id][google.cloud.discoveryengine.v1.Project.ServiceTerms.id] above.
+    string version = 2;
+
+    // Whether the project has accepted/rejected the service terms or it is
+    // still pending.
+    State state = 4;
+
+    // The last time when the project agreed to the terms of service.
+    google.protobuf.Timestamp accept_time = 5;
+
+    // The last time when the project declined or revoked the agreement to terms
+    // of service.
+    google.protobuf.Timestamp decline_time = 6;
+  }
+
+  // Output only. Full resource name of the project, for example
+  // `projects/{project_number}`.
+  // Note that when making requests, project number and project id are both
+  // acceptable, but the server will always respond in project number.
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The timestamp when this project is created.
+  google.protobuf.Timestamp create_time = 2
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The timestamp when this project is successfully provisioned.
+  // Empty value means this project is still provisioning and is not ready for
+  // use.
+  google.protobuf.Timestamp provision_completion_time = 3
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. A map of terms of services. The key is the `id` of
+  // [ServiceTerms][google.cloud.discoveryengine.v1.Project.ServiceTerms].
+  map<string, ServiceTerms> service_terms_map = 4
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}

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

@@ -0,0 +1,90 @@
+// 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/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/discoveryengine/v1/project.proto";
+import "google/longrunning/operations.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 = "ProjectServiceProto";
+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 operations on the
+// [Project][google.cloud.discoveryengine.v1.Project].
+service ProjectService {
+  option (google.api.default_host) = "discoveryengine.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Provisions the project resource. During the
+  // process, related systems will get prepared and initialized.
+  //
+  // Caller must read the [Terms for data
+  // use](https://cloud.google.com/retail/data-use-terms), and optionally
+  // specify in request to provide consent to that service terms.
+  rpc ProvisionProject(ProvisionProjectRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*}:provision"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.discoveryengine.v1.Project"
+      metadata_type: "google.cloud.discoveryengine.v1.ProvisionProjectMetadata"
+    };
+  }
+}
+
+// Request for
+// [ProjectService.ProvisionProject][google.cloud.discoveryengine.v1.ProjectService.ProvisionProject]
+// method.
+message ProvisionProjectRequest {
+  // Required. Full resource name of a
+  // [Project][google.cloud.discoveryengine.v1.Project], such as
+  // `projects/{project_id_or_number}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/Project"
+    }
+  ];
+
+  // Required. Set to `true` to specify that caller has read and would like to
+  // give consent to the [Terms for data
+  // use](https://cloud.google.com/retail/data-use-terms).
+  bool accept_data_use_terms = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The version of the [Terms for data
+  // use](https://cloud.google.com/retail/data-use-terms) that caller has read
+  // and would like to give consent to.
+  //
+  // Acceptable version is `2022-11-23`, and this may change over time.
+  string data_use_terms_version = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Metadata associated with a project provision operation.
+message ProvisionProjectMetadata {}

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

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// 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.