@google-cloud/discoveryengine 1.8.0 → 1.9.0

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

@@ -45,6 +45,9 @@ message Session {
     Query query = 1;
 
     // The resource name of the answer to the user query.
+    //
+    // Only set if the answer generation (/answer API call) happened in this
+    // turn.
     string answer = 2 [(google.api.resource_reference) = {
       type: "discoveryengine.googleapis.com/Answer"
     }];

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

@@ -129,6 +129,9 @@ message TargetSite {
   // Output only. This is system-generated based on the provided_uri_pattern.
   string generated_uri_pattern = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
+  // Output only. Root domain of the provided_uri_pattern.
+  string root_domain_uri = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+
   // Output only. Site ownership and validity verification status.
   SiteVerificationInfo site_verification_info = 7
       [(google.api.field_behavior) = OUTPUT_ONLY];

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

@@ -32,7 +32,7 @@ option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1alpha";
 option ruby_package = "Google::Cloud::DiscoveryEngine::V1alpha";
 
 // UserEvent captures all metadata information Discovery Engine API needs to
-// know about how end users interact with customers' website.
+// know about how end users interact with your website.
 message UserEvent {
   // Required. User event type. Allowed values are:
   //
@@ -74,6 +74,32 @@ message UserEvent {
   // for this field.
   string user_pseudo_id = 2 [(google.api.field_behavior) = REQUIRED];
 
+  // The [Engine][google.cloud.discoveryengine.v1alpha.Engine] resource name, in
+  // the form of
+  // `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.
+  //
+  // Optional. Only required for
+  // [Engine][google.cloud.discoveryengine.v1alpha.Engine] produced user events.
+  // For example, user events from blended search.
+  string engine = 19 [(google.api.resource_reference) = {
+    type: "discoveryengine.googleapis.com/Engine"
+  }];
+
+  // The [DataStore][google.cloud.discoveryengine.v1alpha.DataStore] resource
+  // full name, of the form
+  // `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.
+  //
+  // Optional. Only required for user events whose data store can't by
+  // determined by
+  // [UserEvent.engine][google.cloud.discoveryengine.v1alpha.UserEvent.engine]
+  // or
+  // [UserEvent.documents][google.cloud.discoveryengine.v1alpha.UserEvent.documents].
+  // If data store is set in the parent of write/import/collect user event
+  // requests, this field can be omitted.
+  string data_store = 20 [(google.api.resource_reference) = {
+    type: "discoveryengine.googleapis.com/DataStore"
+  }];
+
   // Only required for
   // [UserEventService.ImportUserEvents][google.cloud.discoveryengine.v1alpha.UserEventService.ImportUserEvents]
   // method. Timestamp of when the user event happened.
@@ -196,7 +222,7 @@ message UserEvent {
 
   // A list of identifiers for the independent experiment groups this user event
   // belongs to. This is used to distinguish between user events associated with
-  // different experiment setups on the customer end.
+  // different experiment setups.
   repeated string tag_ids = 15;
 
   // The promotion IDs if this is an event associated with promotions.
@@ -420,7 +446,7 @@ message DocumentInfo {
 
   // Quantity of the Document associated with the user event. Defaults to 1.
   //
-  // For example, this field will be 2 if two quantities of the same Document
+  // For example, this field is 2 if two quantities of the same Document
   // are involved in a `add-to-cart` event.
   //
   // Required for events of the following event types:

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

@@ -50,6 +50,10 @@ service UserEventService {
         post: "/v1alpha/{parent=projects/*/locations/*/collections/*/dataStores/*}/userEvents:write"
         body: "user_event"
       }
+      additional_bindings {
+        post: "/v1alpha/{parent=projects/*/locations/*}/userEvents:write"
+        body: "user_event"
+      }
     };
   }
 
@@ -87,7 +91,7 @@ service UserEventService {
     };
   }
 
-  // Bulk import of User events. Request processing might be
+  // Bulk import of user events. Request processing might be
   // synchronous. Events that already exist are skipped.
   // Use this method for backfilling historical user events.
   //
@@ -113,8 +117,16 @@ service UserEventService {
 
 // Request message for WriteUserEvent method.
 message WriteUserEventRequest {
-  // Required. The parent DataStore resource name, such as
+  // Required. The parent resource name.
+  // If the write user event action is applied in
+  // [DataStore][google.cloud.discoveryengine.v1alpha.DataStore] level, the
+  // format is:
   // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
+  // If the write user event action is applied in [Location][] level, for
+  // example, the event with
+  // [Document][google.cloud.discoveryengine.v1alpha.Document] across multiple
+  // [DataStore][google.cloud.discoveryengine.v1alpha.DataStore], the format is:
+  // `projects/{project}/locations/{location}`.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -124,6 +136,10 @@ message WriteUserEventRequest {
 
   // Required. User event to write.
   optional UserEvent user_event = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If set to true, the user event is written asynchronously after
+  // validation, and the API responds without waiting for the write.
+  bool write_async = 3;
 }
 
 // Request message for CollectUserEvent method.

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

@@ -18,6 +18,7 @@ package google.cloud.discoveryengine.v1beta;
 
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
@@ -83,6 +84,10 @@ message Answer {
 
       // List of cited chunk contents derived from document content.
       repeated ChunkContent chunk_contents = 4;
+
+      // The structured JSON metadata for the document.
+      // It is populated from the struct data from the Chunk in search result.
+      google.protobuf.Struct struct_data = 5;
     }
 
     // Chunk information.
@@ -102,6 +107,10 @@ message Answer {
 
         // Page identifier.
         string page_identifier = 4;
+
+        // The structured JSON metadata for the document.
+        // It is populated from the struct data from the Chunk in search result.
+        google.protobuf.Struct struct_data = 5;
       }
 
       // Chunk resource name.
@@ -290,7 +299,7 @@ message Answer {
   }
 
   // Immutable. Fully qualified name
-  // `project/*/locations/global/collections/{collection}/engines/{engine}/sessions/*/answers/*`
+  // `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*/answers/*`
   string name = 1 [(google.api.field_behavior) = IMMUTABLE];
 
   // The state of the answer generation.

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

@@ -94,6 +94,22 @@ enum SolutionType {
   SOLUTION_TYPE_GENERATIVE_CHAT = 4;
 }
 
+// Defines a further subdivision of `SolutionType`.
+// Specifically applies to
+// [SOLUTION_TYPE_SEARCH][google.cloud.discoveryengine.v1beta.SolutionType.SOLUTION_TYPE_SEARCH].
+enum SearchUseCase {
+  // Value used when unset. Will not occur in CSS.
+  SEARCH_USE_CASE_UNSPECIFIED = 0;
+
+  // Search use case. Expects the traffic has a non-empty
+  // [query][google.cloud.discoveryengine.v1beta.SearchRequest.query].
+  SEARCH_USE_CASE_SEARCH = 1;
+
+  // Browse use case. Expects the traffic has an empty
+  // [query][google.cloud.discoveryengine.v1beta.SearchRequest.query].
+  SEARCH_USE_CASE_BROWSE = 2;
+}
+
 // Tiers of search features. Different tiers might have different
 // pricing. To learn more, check the pricing documentation.
 enum SearchTier {

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

@@ -0,0 +1,216 @@
+// 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.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/discoveryengine/v1beta/common.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
+option java_multiple_files = true;
+option java_outer_classname = "ControlProto";
+option java_package = "com.google.cloud.discoveryengine.v1beta";
+option objc_class_prefix = "DISCOVERYENGINE";
+option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1beta";
+option ruby_package = "Google::Cloud::DiscoveryEngine::V1beta";
+
+// Defines circumstances to be checked before allowing a behavior
+message Condition {
+  // Matcher for search request query
+  message QueryTerm {
+    // The specific query value to match against
+    //
+    // Must be lowercase, must be UTF-8.
+    // Can have at most 3 space separated terms if full_match is true.
+    // Cannot be an empty string.
+    // Maximum length of 5000 characters.
+    string value = 1;
+
+    // Whether the search query needs to exactly match the query term.
+    bool full_match = 2;
+  }
+
+  // Used for time-dependent conditions.
+  message TimeRange {
+    // Start of time range.
+    //
+    // Range is inclusive.
+    google.protobuf.Timestamp start_time = 1;
+
+    // End of time range.
+    //
+    // Range is inclusive.
+    // Must be in the future.
+    google.protobuf.Timestamp end_time = 2;
+  }
+
+  // Search only
+  // A list of terms to match the query on.
+  //
+  // Maximum of 10 query terms.
+  repeated QueryTerm query_terms = 2;
+
+  // Range of time(s) specifying when condition is active.
+  //
+  // Maximum of 10 time ranges.
+  repeated TimeRange active_time_range = 3;
+}
+
+// Defines a conditioned behavior to employ during serving.
+// Must be attached to a
+// [ServingConfig][google.cloud.discoveryengine.v1beta.ServingConfig] to be
+// considered at serving time. Permitted actions dependent on `SolutionType`.
+message Control {
+  option (google.api.resource) = {
+    type: "discoveryengine.googleapis.com/Control"
+    pattern: "projects/{project}/locations/{location}/dataStores/{data_store}/controls/{control}"
+    pattern: "projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/controls/{control}"
+    pattern: "projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/controls/{control}"
+  };
+
+  // Adjusts order of products in returned list.
+  message BoostAction {
+    // Required. Strength of the boost, which should be in [-1, 1]. Negative
+    // boost means demotion. Default is 0.0 (No-op).
+    float boost = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. Specifies which products to apply the boost to.
+    //
+    // If no filter is provided all products will be boosted (No-op).
+    // Syntax documentation:
+    // https://cloud.google.com/retail/docs/filter-and-order
+    // Maximum length is 5000 characters.
+    // Otherwise an INVALID ARGUMENT error is thrown.
+    string filter = 2 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. Specifies which data store's documents can be boosted by this
+    // control. Full data store name e.g.
+    // projects/123/locations/global/collections/default_collection/dataStores/default_data_store
+    string data_store = 3 [
+      (google.api.field_behavior) = REQUIRED,
+      (google.api.resource_reference) = {
+        type: "discoveryengine.googleapis.com/DataStore"
+      }
+    ];
+  }
+
+  // Specified which products may be included in results.
+  // Uses same filter as boost.
+  message FilterAction {
+    // Required. A filter to apply on the matching condition results.
+    //
+    // Required
+    // Syntax documentation:
+    // https://cloud.google.com/retail/docs/filter-and-order
+    // Maximum length is 5000 characters. Otherwise an INVALID
+    // ARGUMENT error is thrown.
+    string filter = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. Specifies which data store's documents can be filtered by this
+    // control. Full data store name e.g.
+    // projects/123/locations/global/collections/default_collection/dataStores/default_data_store
+    string data_store = 2 [
+      (google.api.field_behavior) = REQUIRED,
+      (google.api.resource_reference) = {
+        type: "discoveryengine.googleapis.com/DataStore"
+      }
+    ];
+  }
+
+  // Redirects a shopper to the provided URI.
+  message RedirectAction {
+    // Required. The URI to which the shopper will be redirected.
+    //
+    // Required.
+    // URI must have length equal or less than 2000 characters.
+    // Otherwise an INVALID ARGUMENT error is thrown.
+    string redirect_uri = 1 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // Creates a set of terms that will act as synonyms of one another.
+  //
+  // Example: "happy" will also be considered as "glad", "glad" will also be
+  // considered as "happy".
+  message SynonymsAction {
+    // Defines a set of synonyms.
+    // Can specify up to 100 synonyms.
+    // Must specify at least 2 synonyms. Otherwise an INVALID ARGUMENT error is
+    // thrown.
+    repeated string synonyms = 1;
+  }
+
+  // Actions are restricted by Vertical and Solution
+  //
+  // Required.
+  oneof action {
+    // Defines a boost-type control
+    BoostAction boost_action = 6;
+
+    // Defines a filter-type control
+    // Currently not supported by Recommendation
+    FilterAction filter_action = 7;
+
+    // Defines a redirect-type control.
+    RedirectAction redirect_action = 9;
+
+    // Treats a group of terms as synonyms of one another.
+    SynonymsAction synonyms_action = 10;
+  }
+
+  // Immutable. Fully qualified name
+  // `projects/*/locations/global/dataStore/*/controls/*`
+  string name = 1 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Required. Human readable name. The identifier used in UI views.
+  //
+  // Must be UTF-8 encoded string. Length limit is 128 characters.
+  // Otherwise an INVALID ARGUMENT error is thrown.
+  string display_name = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. List of all
+  // [ServingConfig][google.cloud.discoveryengine.v1beta.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];
+
+  // Required. Immutable. What solution the control belongs to.
+  //
+  // Must be compatible with vertical of resource.
+  // Otherwise an INVALID ARGUMENT error is thrown.
+  SolutionType solution_type = 4 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.field_behavior) = IMMUTABLE
+  ];
+
+  // Specifies the use case for the control.
+  // Affects what condition fields can be set.
+  // Only applies to
+  // [SOLUTION_TYPE_SEARCH][google.cloud.discoveryengine.v1beta.SolutionType.SOLUTION_TYPE_SEARCH].
+  // Currently only allow one use case per control.
+  // Must be set when solution_type is
+  // [SolutionType.SOLUTION_TYPE_SEARCH][google.cloud.discoveryengine.v1beta.SolutionType.SOLUTION_TYPE_SEARCH].
+  repeated SearchUseCase use_cases = 8;
+
+  // Determines when the associated action will trigger.
+  //
+  // Omit to always apply the action.
+  // Currently only a single condition may be specified.
+  // Otherwise an INVALID ARGUMENT error is thrown.
+  repeated Condition conditions = 5;
+}

package/build/protos/google/cloud/discoveryengine/v1beta/control_service.proto

@@ -0,0 +1,236 @@
+// 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.v1beta;
+
+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/v1beta/control.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
+option java_multiple_files = true;
+option java_outer_classname = "ControlServiceProto";
+option java_package = "com.google.cloud.discoveryengine.v1beta";
+option objc_class_prefix = "DISCOVERYENGINE";
+option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1beta";
+option ruby_package = "Google::Cloud::DiscoveryEngine::V1beta";
+
+// Service for performing CRUD operations on Controls.
+// Controls allow for custom logic to be implemented in the serving path.
+// Controls need to be attached to a Serving Config to be considered during a
+// request.
+service ControlService {
+  option (google.api.default_host) = "discoveryengine.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates a Control.
+  //
+  // By default 1000 controls are allowed for a data store.
+  // A request can be submitted to adjust this limit.
+  // If the [Control][google.cloud.discoveryengine.v1beta.Control] to create
+  // already exists, an ALREADY_EXISTS error is returned.
+  rpc CreateControl(CreateControlRequest) returns (Control) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/dataStores/*}/controls"
+      body: "control"
+      additional_bindings {
+        post: "/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/controls"
+        body: "control"
+      }
+      additional_bindings {
+        post: "/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/controls"
+        body: "control"
+      }
+    };
+    option (google.api.method_signature) = "parent,control,control_id";
+  }
+
+  // Deletes a Control.
+  //
+  // If the [Control][google.cloud.discoveryengine.v1beta.Control] to delete
+  // does not exist, a NOT_FOUND error is returned.
+  rpc DeleteControl(DeleteControlRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta/{name=projects/*/locations/*/dataStores/*/controls/*}"
+      additional_bindings {
+        delete: "/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/controls/*}"
+      }
+      additional_bindings {
+        delete: "/v1beta/{name=projects/*/locations/*/collections/*/engines/*/controls/*}"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates a Control.
+  //
+  // [Control][google.cloud.discoveryengine.v1beta.Control] action type cannot
+  // be changed. If the [Control][google.cloud.discoveryengine.v1beta.Control]
+  // to update does not exist, a NOT_FOUND error is returned.
+  rpc UpdateControl(UpdateControlRequest) returns (Control) {
+    option (google.api.http) = {
+      patch: "/v1beta/{control.name=projects/*/locations/*/dataStores/*/controls/*}"
+      body: "control"
+      additional_bindings {
+        patch: "/v1beta/{control.name=projects/*/locations/*/collections/*/dataStores/*/controls/*}"
+        body: "control"
+      }
+      additional_bindings {
+        patch: "/v1beta/{control.name=projects/*/locations/*/collections/*/engines/*/controls/*}"
+        body: "control"
+      }
+    };
+    option (google.api.method_signature) = "control,update_mask";
+  }
+
+  // Gets a Control.
+  rpc GetControl(GetControlRequest) returns (Control) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/locations/*/dataStores/*/controls/*}"
+      additional_bindings {
+        get: "/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/controls/*}"
+      }
+      additional_bindings {
+        get: "/v1beta/{name=projects/*/locations/*/collections/*/engines/*/controls/*}"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists all Controls by their parent
+  // [DataStore][google.cloud.discoveryengine.v1beta.DataStore].
+  rpc ListControls(ListControlsRequest) returns (ListControlsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*/locations/*/dataStores/*}/controls"
+      additional_bindings {
+        get: "/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/controls"
+      }
+      additional_bindings {
+        get: "/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/controls"
+      }
+    };
+    option (google.api.method_signature) = "parent";
+  }
+}
+
+// Request for CreateControl method.
+message CreateControlRequest {
+  // Required. Full resource name of parent data store. Format:
+  // `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+  // or
+  // `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "discoveryengine.googleapis.com/Control"
+    }
+  ];
+
+  // Required. The Control to create.
+  Control control = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The ID to use for the Control, which will become the final
+  // component of the Control's resource name.
+  //
+  // This value must be within 1-63 characters.
+  // Valid characters are /[a-z][0-9]-_/.
+  string control_id = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request for UpdateControl method.
+message UpdateControlRequest {
+  // Required. The Control to update.
+  Control control = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Indicates which fields in the provided
+  // [Control][google.cloud.discoveryengine.v1beta.Control] to update. The
+  // following are NOT supported:
+  //
+  // * [Control.name][google.cloud.discoveryengine.v1beta.Control.name]
+  // * [Control.solution_type][google.cloud.discoveryengine.v1beta.Control.solution_type]
+  //
+  // If not set or empty, all supported fields are updated.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request for DeleteControl method.
+message DeleteControlRequest {
+  // Required. The resource name of the Control to delete. Format:
+  // `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/Control"
+    }
+  ];
+}
+
+// Request for GetControl method.
+message GetControlRequest {
+  // Required. The resource name of the Control to get. Format:
+  // `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/Control"
+    }
+  ];
+}
+
+// Request for ListControls method.
+message ListControlsRequest {
+  // Required. The data store resource name. Format:
+  // `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+  // or
+  // `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "discoveryengine.googleapis.com/Control"
+    }
+  ];
+
+  // Optional. Maximum number of results to return. If unspecified, defaults
+  // to 50. Max allowed value is 1000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A page token, received from a previous `ListControls` call.
+  // Provide this to retrieve the subsequent page.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A filter to apply on the list results. Supported features:
+  //
+  // * List all the products under the parent branch if
+  // [filter][google.cloud.discoveryengine.v1beta.ListControlsRequest.filter] is
+  // unset. Currently this field is unsupported.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response for ListControls method.
+message ListControlsResponse {
+  // All the Controls for a given data store.
+  repeated Control controls = 1;
+
+  // Pagination token, if not returned indicates the last page.
+  string next_page_token = 2;
+}

package/build/protos/google/cloud/discoveryengine/v1beta/conversation.proto

@@ -52,9 +52,9 @@ message Conversation {
   }
 
   // Immutable. Fully qualified name
-  // `project/*/locations/global/collections/{collection}/dataStore/*/conversations/*`
+  // `projects/{project}/locations/global/collections/{collection}/dataStore/*/conversations/*`
   // or
-  // `project/*/locations/global/collections/{collection}/engines/*/conversations/*`.
+  // `projects/{project}/locations/global/collections/{collection}/engines/*/conversations/*`.
   string name = 1 [(google.api.field_behavior) = IMMUTABLE];
 
   // The state of the Conversation.