@google-cloud/discoveryengine 1.4.0 → 1.5.0

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

@@ -82,7 +82,7 @@ message Engine {
       TRAINING = 2;
     }
 
-    // Required. The type of engine e.g. `recommended-for-you`.
+    // Required. The type of engine. e.g., `recommended-for-you`.
     //
     // This field together with
     // [optimization_objective][Engine.optimization_objective] describe engine
@@ -92,7 +92,7 @@ message Engine {
     // `more-like-this`, `most-popular-items`.
     string type = 1 [(google.api.field_behavior) = REQUIRED];
 
-    // The optimization objective e.g. `cvr`.
+    // The optimization objective. e.g., `cvr`.
     //
     // This field together with
     // [optimization_objective][google.cloud.discoveryengine.v1alpha.Engine.MediaRecommendationEngineConfig.type]
@@ -155,6 +155,11 @@ message Engine {
       // database](https://www.iana.org/time-zones), e.g., America/New_York,
       // Europe/Paris.
       string time_zone = 3 [(google.api.field_behavior) = REQUIRED];
+
+      // Agent location for Agent creation, supported values: global/us/eu.
+      // If not provided, us Engine will create Agent using us-central-1 by
+      // default; eu Engine will create Agent using eu-west-1 by default.
+      string location = 4;
     }
 
     // The configurationt generate the Dialogflow agent that is associated to
@@ -181,16 +186,16 @@ message Engine {
     // or
     // [EngineService.ListEngines][google.cloud.discoveryengine.v1alpha.EngineService.ListEngines]
     // API after engine creation. Please use
-    // [chat_engine_metadata.dialogflow_agent][] for actual agent
-    // association after Engine is created.
+    // [ChatEngineMetadata.dialogflow_agent][google.cloud.discoveryengine.v1alpha.Engine.ChatEngineMetadata.dialogflow_agent]
+    // for actual agent association after Engine is created.
     string dialogflow_agent_to_link = 2;
   }
 
   // Common configurations for an Engine.
   message CommonConfig {
-    // 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;
+    // 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];
   }
 
   // Additional information of a recommendation engine.
@@ -352,7 +357,7 @@ message Engine {
   // Note that when used in
   // [CreateEngineRequest][google.cloud.discoveryengine.v1alpha.CreateEngineRequest],
   // one DataStore id must be provided as the system will use it for necessary
-  // intializations.
+  // initializations.
   repeated string data_store_ids = 5;
 
   // Required. The solutions of the engine.

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

@@ -94,7 +94,7 @@ service EngineService {
   }
 
   // Pauses the training of an existing engine. Only applicable if
-  // [solution_type][] is
+  // [SolutionType][google.cloud.discoveryengine.v1alpha.SolutionType] is
   // [SOLUTION_TYPE_RECOMMENDATION][google.cloud.discoveryengine.v1alpha.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
   rpc PauseEngine(PauseEngineRequest) returns (Engine) {
     option (google.api.http) = {
@@ -115,7 +115,8 @@ service EngineService {
     option (google.api.method_signature) = "name";
   }
 
-  // Tunes an existing engine. Only applicable if [solution_type][] is
+  // Tunes an existing engine. Only applicable if
+  // [SolutionType][google.cloud.discoveryengine.v1alpha.SolutionType] is
   // [SOLUTION_TYPE_RECOMMENDATION][google.cloud.discoveryengine.v1alpha.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
   rpc TuneEngine(TuneEngineRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {

package/build/protos/google/cloud/discoveryengine/v1alpha/estimate_billing_service.proto

@@ -0,0 +1,130 @@
+// Copyright 2022 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.v1alpha;
+
+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/v1alpha/import_config.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Alpha";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1alpha/discoveryenginepb;discoveryenginepb";
+option java_multiple_files = true;
+option java_outer_classname = "EstimateBillingServiceProto";
+option java_package = "com.google.cloud.discoveryengine.v1alpha";
+option objc_class_prefix = "DISCOVERYENGINE";
+option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1alpha";
+option ruby_package = "Google::Cloud::DiscoveryEngine::V1alpha";
+
+// Service for managing billing estimations resources.
+service EstimateBillingService {
+  option (google.api.default_host) = "discoveryengine.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Estimates the data size to be used by a customer.
+  rpc EstimateDataSize(EstimateDataSizeRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1alpha/{location=projects/*/locations/*}:estimateDataSize"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.discoveryengine.v1alpha.EstimateDataSizeResponse"
+      metadata_type: "google.cloud.discoveryengine.v1alpha.EstimateDataSizeMetadata"
+    };
+  }
+}
+
+// Request message for
+// [EstimateBillingService.EstimateDataSize][google.cloud.discoveryengine.v1alpha.EstimateBillingService.EstimateDataSize]
+// method
+message EstimateDataSizeRequest {
+  // Data source is a set of website patterns that we crawl to get
+  // the total number of websites.
+  message WebsiteDataSource {
+    // URI patterns that we use to crawl.
+    message EstimatorUriPattern {
+      // User provided URI pattern. For example, `foo.com/bar/*`.
+      string provided_uri_pattern = 1;
+
+      // Whether we infer the generated URI or use the exact provided one.
+      bool exact_match = 2;
+
+      // Whether the pattern is exclusive or not. If set to true, the pattern is
+      // considered exclusive. If unset or set to false, the pattern is
+      // considered inclusive by default.
+      bool exclusive = 3;
+    }
+
+    // Required. The URI patterns to estimate the data sizes. At most 10
+    // patterns are allowed, otherwise an INVALID_ARGUMENT error is thrown.
+    repeated EstimatorUriPattern estimator_uri_patterns = 1
+        [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // Data source contains files either in Cloud Storage or BigQuery.
+  message FileDataSource {
+    // Which source contains the files to be used.
+    oneof source {
+      // Cloud Storage location for the input content.
+      GcsSource gcs_source = 1;
+
+      // BigQuery input source.
+      BigQuerySource bigquery_source = 2;
+    }
+  }
+
+  // Data source for which we are estimating its size.
+  oneof data_source {
+    // Website data.
+    WebsiteDataSource website_data_source = 2;
+
+    // Structured or unstructured data.
+    FileDataSource file_data_source = 3;
+  }
+
+  // Required. Full resource name of the location, such as
+  // `projects/{project}/locations/{location}`.
+  string location = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/Location"
+    }
+  ];
+}
+
+// Response of the EstimateDataSize request. If the long running
+// operation was successful, then this message is returned by the
+// google.longrunning.Operations.response field if the operation was successful.
+message EstimateDataSizeResponse {
+  // Data size in terms of bytes.
+  int64 data_size_bytes = 1;
+
+  // Total number of documents.
+  int64 document_count = 2;
+}
+
+// Metadata related to the progress of the EstimateDataSize operation. This is
+// returned by the google.longrunning.Operation.metadata field.
+message EstimateDataSizeMetadata {
+  // Operation create time.
+  google.protobuf.Timestamp create_time = 1;
+}

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

@@ -18,8 +18,10 @@ package google.cloud.discoveryengine.v1alpha;
 
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/cloud/discoveryengine/v1alpha/completion.proto";
 import "google/cloud/discoveryengine/v1alpha/document.proto";
 import "google/cloud/discoveryengine/v1alpha/user_event.proto";
+import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
 import "google/type/date.proto";
@@ -122,6 +124,233 @@ message BigQuerySource {
   string data_schema = 6;
 }
 
+// The Spanner source for importing data
+message SpannerSource {
+  // The project ID that the Spanner source is in with a length limit of 128
+  // characters. If not specified, inherits the project ID from the parent
+  // request.
+  string project_id = 1;
+
+  // Required. The instance ID of the source Spanner table.
+  string instance_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The database ID of the source Spanner table.
+  string database_id = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The table name of the Spanner database that needs to be imported.
+  string table_id = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Whether to apply data boost on Spanner export. Enabling this option will
+  // incur additional cost. More info can be found
+  // [here](https://cloud.google.com/spanner/docs/databoost/databoost-overview#billing_and_quotas).
+  bool enable_data_boost = 5;
+}
+
+// The Bigtable Options object that contains information to support
+// the import.
+message BigtableOptions {
+  // The column family of the Bigtable.
+  message BigtableColumnFamily {
+    // The field name to use for this column family in the document. The
+    // name has to match the pattern `[a-zA-Z0-9][a-zA-Z0-9-_]*`. If not set,
+    // it is parsed from the family name with best effort. However, due to
+    // different naming patterns, field name collisions could happen, where
+    // parsing behavior is undefined.
+    string field_name = 1;
+
+    // The encoding mode of the values when the type is not STRING.
+    // Acceptable encoding values are:
+    //
+    // * `TEXT`: indicates values are alphanumeric text strings.
+    // * `BINARY`: indicates values are encoded using `HBase Bytes.toBytes`
+    // family of functions. This can be overridden for a specific column
+    // by listing that column in `columns` and specifying an encoding for it.
+    Encoding encoding = 2;
+
+    // The type of values in this column family.
+    // The values are expected to be encoded using `HBase Bytes.toBytes`
+    // function when the encoding value is set to `BINARY`.
+    Type type = 3;
+
+    // The list of objects that contains column level information for each
+    // column. If a column is not present in this list it will be ignored.
+    repeated BigtableColumn columns = 4;
+  }
+
+  // The column of the Bigtable.
+  message BigtableColumn {
+    // Required. Qualifier of the column. If it cannot be decoded with utf-8,
+    // use a base-64 encoded string instead.
+    bytes qualifier = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // The field name to use for this column in the document. The name has to
+    // match the pattern `[a-zA-Z0-9][a-zA-Z0-9-_]*`.
+    // If not set, it is parsed from the qualifier bytes with best effort.
+    // However, due to different naming patterns, field name collisions could
+    // happen, where parsing behavior is undefined.
+    string field_name = 2;
+
+    // The encoding mode of the values when the type is not `STRING`.
+    // Acceptable encoding values are:
+    //
+    // * `TEXT`: indicates values are alphanumeric text strings.
+    // * `BINARY`: indicates values are encoded using `HBase Bytes.toBytes`
+    // family of functions. This can be overridden for a specific column
+    // by listing that column in `columns` and specifying an encoding for it.
+    Encoding encoding = 3;
+
+    // The type of values in this column family.
+    // The values are expected to be encoded using `HBase Bytes.toBytes`
+    // function when the encoding value is set to `BINARY`.
+    Type type = 4;
+  }
+
+  // The type of values in a Bigtable column or column family.
+  // The values are expected to be encoded using
+  // [HBase
+  // Bytes.toBytes](https://hbase.apache.org/apidocs/org/apache/hadoop/hbase/util/Bytes.html)
+  // function when the encoding value is set to `BINARY`.
+  enum Type {
+    // The type is unspecified.
+    TYPE_UNSPECIFIED = 0;
+
+    // String type.
+    STRING = 1;
+
+    // Numerical type.
+    NUMBER = 2;
+
+    // Integer type.
+    INTEGER = 3;
+
+    // Variable length integer type.
+    VAR_INTEGER = 4;
+
+    // BigDecimal type.
+    BIG_NUMERIC = 5;
+
+    // Boolean type.
+    BOOLEAN = 6;
+
+    // JSON type.
+    JSON = 7;
+  }
+
+  // The encoding mode of a Bigtable column or column family.
+  enum Encoding {
+    // The encoding is unspecified.
+    ENCODING_UNSPECIFIED = 0;
+
+    // Text encoding.
+    TEXT = 1;
+
+    // Binary encoding.
+    BINARY = 2;
+  }
+
+  // The field name used for saving row key value in the document. The name has
+  // to match the pattern `[a-zA-Z0-9][a-zA-Z0-9-_]*`.
+  string key_field_name = 1;
+
+  // The mapping from family names to an object that contains column families
+  // level information for the given column family. If a family is not present
+  // in this map it will be ignored.
+  map<string, BigtableColumnFamily> families = 2;
+}
+
+// The Cloud Bigtable source for importing data.
+message BigtableSource {
+  // The project ID that the Bigtable source is in with a length limit of 128
+  // characters. If not specified, inherits the project ID from the parent
+  // request.
+  string project_id = 1;
+
+  // Required. The instance ID of the Cloud Bigtable that needs to be imported.
+  string instance_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The table ID of the Cloud Bigtable that needs to be imported.
+  string table_id = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Bigtable options that contains information needed when parsing
+  // data into typed structures. For example, column type annotations.
+  BigtableOptions bigtable_options = 4 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Cloud FhirStore source import data from.
+message FhirStoreSource {
+  // Required. The full resource name of the FHIR store to import data from, in
+  // the format of
+  // `projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}`.
+  string fhir_store = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "healthcare.googleapis.com/FhirStore"
+    }
+  ];
+
+  // Intermediate Cloud Storage directory used for the import with a length
+  // 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;
+}
+
+// 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
+  // request.
+  string project_id = 1;
+
+  // Required. The Cloud SQL instance to copy the data from with a length limit
+  // of 256 characters.
+  string instance_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Cloud SQL database to copy the data from with a length limit
+  // of 256 characters.
+  string database_id = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Cloud SQL table to copy the data from with a length limit of
+  // 256 characters.
+  string table_id = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Intermediate Cloud Storage directory used for the import with a length
+  // limit of 2,000 characters. Can be specified if one wants to have the
+  // Cloud SQL export to a specific Cloud Storage directory.
+  //
+  // Please ensure that the Cloud SQL service account has the necessary Cloud
+  // Storage Admin permissions to access the specified Cloud Storage directory.
+  string gcs_staging_dir = 5;
+
+  // Option for serverless export. Enabling this option will incur
+  // additional cost. More info can be found
+  // [here](https://cloud.google.com/sql/pricing#serverless).
+  bool offload = 6;
+}
+
+// Firestore source import data from.
+message FirestoreSource {
+  // 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
+  // request.
+  string project_id = 1;
+
+  // Required. The Firestore database to copy the data from with a length limit
+  // 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.
+  string collection_id = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Intermediate Cloud Storage directory used for the import with a length
+  // limit of 2,000 characters. Can be specified if one wants to have the
+  // Firestore export to a specific Cloud Storage directory.
+  //
+  // Please ensure that the Firestore service account has the necessary Cloud
+  // Storage Admin permissions to access the specified Cloud Storage directory.
+  string gcs_staging_dir = 4;
+}
+
 // Configuration of destination for Import related errors.
 message ImportErrorConfig {
   // Required. Errors destination.
@@ -219,6 +448,9 @@ message ImportDocumentsMetadata {
 
   // Count of entries that encountered errors while processing.
   int64 failure_count = 4;
+
+  // Total count of entries that were processed.
+  int64 total_count = 5;
 }
 
 // Request message for Import methods.
@@ -255,6 +487,21 @@ message ImportDocumentsRequest {
 
     // BigQuery input source.
     BigQuerySource bigquery_source = 4;
+
+    // FhirStore input source.
+    FhirStoreSource fhir_store_source = 10;
+
+    // Spanner input source.
+    SpannerSource spanner_source = 11;
+
+    // Cloud SQL input source.
+    CloudSqlSource cloud_sql_source = 12;
+
+    // Firestore input source.
+    FirestoreSource firestore_source = 13;
+
+    // Cloud Bigtable input source.
+    BigtableSource bigtable_source = 15;
   }
 
   // Required. The parent branch resource name, such as
@@ -275,6 +522,10 @@ message ImportDocumentsRequest {
   // [ReconciliationMode.INCREMENTAL][google.cloud.discoveryengine.v1alpha.ImportDocumentsRequest.ReconciliationMode.INCREMENTAL].
   ReconciliationMode reconciliation_mode = 6;
 
+  // Indicates which fields in the provided imported documents to update. If
+  // not set, the default is to update all fields.
+  google.protobuf.FieldMask update_mask = 7;
+
   // Whether to automatically generate IDs for the documents if absent.
   //
   // If set to `true`,
@@ -288,45 +539,54 @@ message ImportDocumentsRequest {
   // [id_field][google.cloud.discoveryengine.v1alpha.ImportDocumentsRequest.id_field],
   // otherwise, documents without IDs fail to be imported.
   //
-  // Only set this field when using
-  // [GcsSource][google.cloud.discoveryengine.v1alpha.GcsSource] or
-  // [BigQuerySource][google.cloud.discoveryengine.v1alpha.BigQuerySource], and
-  // when
+  // Supported data sources:
+  //
+  // * [GcsSource][google.cloud.discoveryengine.v1alpha.GcsSource].
   // [GcsSource.data_schema][google.cloud.discoveryengine.v1alpha.GcsSource.data_schema]
-  // or
+  // must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown.
+  // * [BigQuerySource][google.cloud.discoveryengine.v1alpha.BigQuerySource].
   // [BigQuerySource.data_schema][google.cloud.discoveryengine.v1alpha.BigQuerySource.data_schema]
-  // is `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown.
+  // must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown.
+  // * [SpannerSource][google.cloud.discoveryengine.v1alpha.SpannerSource].
+  // * [CloudSqlSource][google.cloud.discoveryengine.v1alpha.CloudSqlSource].
+  // * [FirestoreSource][google.cloud.discoveryengine.v1alpha.FirestoreSource].
+  // * [BigtableSource][google.cloud.discoveryengine.v1alpha.BigtableSource].
   bool auto_generate_ids = 8;
 
-  // The field in the Cloud Storage and BigQuery sources that indicates the
-  // unique IDs of the documents.
+  // The field indicates the ID field or column to be used as unique IDs of
+  // the documents.
   //
   // For [GcsSource][google.cloud.discoveryengine.v1alpha.GcsSource] it is the
   // key of the JSON field. For instance, `my_id` for JSON `{"my_id":
-  // "some_uuid"}`. For
-  // [BigQuerySource][google.cloud.discoveryengine.v1alpha.BigQuerySource] it is
-  // the column name of the BigQuery table where the unique ids are stored.
+  // "some_uuid"}`. For others, it may be the column name of the table where the
+  // unique ids are stored.
   //
-  // The values of the JSON field or the BigQuery column are used as the
+  // The values of the JSON field or the table column are used as the
   // [Document.id][google.cloud.discoveryengine.v1alpha.Document.id]s. The JSON
-  // field or the BigQuery column must be of string type, and the values must be
+  // field or the table column must be of string type, and the values must be
   // set as valid strings conform to
   // [RFC-1034](https://tools.ietf.org/html/rfc1034) with 1-63 characters.
   // Otherwise, documents without valid IDs fail to be imported.
   //
-  // Only set this field when using
-  // [GcsSource][google.cloud.discoveryengine.v1alpha.GcsSource] or
-  // [BigQuerySource][google.cloud.discoveryengine.v1alpha.BigQuerySource], and
-  // when
-  // [GcsSource.data_schema][google.cloud.discoveryengine.v1alpha.GcsSource.data_schema]
-  // or
-  // [BigQuerySource.data_schema][google.cloud.discoveryengine.v1alpha.BigQuerySource.data_schema]
-  // is `custom`. And only set this field when
+  // Only set this field when
   // [auto_generate_ids][google.cloud.discoveryengine.v1alpha.ImportDocumentsRequest.auto_generate_ids]
   // is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown.
   //
   // If it is unset, a default value `_id` is used when importing from the
   // allowed data sources.
+  //
+  // Supported data sources:
+  //
+  // * [GcsSource][google.cloud.discoveryengine.v1alpha.GcsSource].
+  // [GcsSource.data_schema][google.cloud.discoveryengine.v1alpha.GcsSource.data_schema]
+  // must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown.
+  // * [BigQuerySource][google.cloud.discoveryengine.v1alpha.BigQuerySource].
+  // [BigQuerySource.data_schema][google.cloud.discoveryengine.v1alpha.BigQuerySource.data_schema]
+  // must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown.
+  // * [SpannerSource][google.cloud.discoveryengine.v1alpha.SpannerSource].
+  // * [CloudSqlSource][google.cloud.discoveryengine.v1alpha.CloudSqlSource].
+  // * [FirestoreSource][google.cloud.discoveryengine.v1alpha.FirestoreSource].
+  // * [BigtableSource][google.cloud.discoveryengine.v1alpha.BigtableSource].
   string id_field = 9;
 }
 
@@ -341,3 +601,98 @@ message ImportDocumentsResponse {
   // Echoes the destination for the complete errors in the request if set.
   ImportErrorConfig error_config = 2;
 }
+
+// Request message for
+// [CompletionService.ImportSuggestionDenyListEntries][google.cloud.discoveryengine.v1alpha.CompletionService.ImportSuggestionDenyListEntries]
+// method.
+message ImportSuggestionDenyListEntriesRequest {
+  // The inline source for SuggestionDenyListEntry.
+  message InlineSource {
+    // Required. A list of all denylist entries to import. Max of 1000 items.
+    repeated SuggestionDenyListEntry entries = 1
+        [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // The source of the updated SuggestionDenyList.
+  oneof source {
+    // The Inline source for the input content for suggestion deny list entries.
+    InlineSource inline_source = 2;
+
+    // Cloud Storage location for the input content.
+    //
+    // Only 1 file can be specified that contains all entries to import.
+    // Supported values `gcs_source.schema` for autocomplete suggestion deny
+    // list entry imports:
+    //
+    // * `suggestion_deny_list` (default): One JSON [SuggestionDenyListEntry]
+    // per line.
+    GcsSource gcs_source = 3;
+  }
+
+  // Required. The parent data store resource name for which to import denylist
+  // entries. Follows pattern projects/*/locations/*/collections/*/dataStores/*.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/DataStore"
+    }
+  ];
+}
+
+// Response message for
+// [CompletionService.ImportSuggestionDenyListEntries][google.cloud.discoveryengine.v1alpha.CompletionService.ImportSuggestionDenyListEntries]
+// method.
+message ImportSuggestionDenyListEntriesResponse {
+  // A sample of errors encountered while processing the request.
+  repeated google.rpc.Status error_samples = 1;
+
+  // Count of deny list entries successfully imported.
+  int64 imported_entries_count = 2;
+
+  // Count of deny list entries that failed to be imported.
+  int64 failed_entries_count = 3;
+}
+
+// Metadata related to the progress of the ImportSuggestionDenyListEntries
+// operation. This is returned by the google.longrunning.Operation.metadata
+// field.
+message ImportSuggestionDenyListEntriesMetadata {
+  // 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;
+}
+
+// Response of the
+// [CompletionService.ImportCompletionSuggestions][google.cloud.discoveryengine.v1alpha.CompletionService.ImportCompletionSuggestions]
+// method. If the long running operation is done, this message is returned by
+// the google.longrunning.Operations.response field if the operation is
+// successful.
+message ImportCompletionSuggestionsResponse {
+  // A sample of errors encountered while processing the request.
+  repeated google.rpc.Status error_samples = 1;
+
+  // Count of
+  // [CompletionSuggestion][google.cloud.discoveryengine.v1alpha.CompletionSuggestion]s
+  // successfully imported.
+  int64 success_count = 2;
+
+  // Count of
+  // [CompletionSuggestion][google.cloud.discoveryengine.v1alpha.CompletionSuggestion]s
+  // that failed to be imported.
+  int64 failure_count = 3;
+}
+
+// Metadata related to the progress of the ImportCompletionSuggestions
+// operation. This will be returned by the google.longrunning.Operation.metadata
+// field.
+message ImportCompletionSuggestionsMetadata {
+  // 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;
+}