@google-cloud/discoveryengine 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.4.0](https://github.com/googleapis/google-cloud-node/compare/discoveryengine-v0.3.1...discoveryengine-v0.4.0) (2023-03-28)
+
+
+### Features
+
+* [discoveryengine] add additional resource path with collections ([#4120](https://github.com/googleapis/google-cloud-node/issues/4120)) ([0fe6ff4](https://github.com/googleapis/google-cloud-node/commit/0fe6ff44b808fa9afc4c452402bc013805f74a97))
+
+## [0.3.1](https://github.com/googleapis/google-cloud-node/compare/discoveryengine-v0.3.0...discoveryengine-v0.3.1) (2023-02-15)
+
+
+### Bug Fixes
+
+* [Many APIs] changing format of the jsdoc links ([#3987](https://github.com/googleapis/google-cloud-node/issues/3987)) ([07043a6](https://github.com/googleapis/google-cloud-node/commit/07043a629545ad418f33f90f9f96147a136e1728))
+
 ## [0.3.0](https://github.com/googleapis/google-cloud-node/compare/discoveryengine-v0.2.0...discoveryengine-v0.3.0) (2023-01-28)
 
 

package/README.md

@@ -4,7 +4,7 @@
 
 # [Discovery Engine API: Node.js Client](https://github.com/googleapis/google-cloud-node)
 
-[![release level](https://img.shields.io/badge/release%20level-beta-yellow.svg?style=flat)](https://cloud.google.com/terms/launch-stages)
+[![release level](https://img.shields.io/badge/release%20level-preview-yellow.svg?style=flat)](https://cloud.google.com/terms/launch-stages)
 [![npm version](https://img.shields.io/npm/v/@google-cloud/discoveryengine.svg)](https://www.npmjs.org/package/@google-cloud/discoveryengine)
 
 
@@ -171,13 +171,12 @@ This library follows [Semantic Versioning](http://semver.org/).
 
 
 
-This library is considered to be in **beta**. This means it is expected to be
-mostly stable while we work toward a general availability release; however,
-complete stability is not guaranteed. We will address issues and requests
-against beta libraries with a high priority.
 
 
 
+This library is considered to be in **preview**. This means it is still a
+work-in-progress and under active development. Any release is subject to
+backwards-incompatible changes at any time.
 
 
 More Information: [Google Cloud Platform Launch Stages][launch_stages]

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

@@ -19,7 +19,7 @@ package google.cloud.discoveryengine.v1beta;
 import "google/api/resource.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
-option go_package = "google.golang.org/genproto/googleapis/cloud/discoveryengine/v1beta;discoveryengine";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
 option java_multiple_files = true;
 option java_outer_classname = "CommonProto";
 option java_package = "com.google.cloud.discoveryengine.v1beta";
@@ -29,14 +29,17 @@ option ruby_package = "Google::Cloud::DiscoveryEngine::V1beta";
 option (google.api.resource_definition) = {
   type: "discoveryengine.googleapis.com/Branch"
   pattern: "projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}"
+  pattern: "projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}"
 };
 option (google.api.resource_definition) = {
   type: "discoveryengine.googleapis.com/DataStore"
   pattern: "projects/{project}/locations/{location}/dataStores/{data_store}"
+  pattern: "projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}"
 };
 option (google.api.resource_definition) = {
   type: "discoveryengine.googleapis.com/ServingConfig"
   pattern: "projects/{project}/locations/{location}/dataStores/{data_store}/servingConfigs/{serving_config}"
+  pattern: "projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/servingConfigs/{serving_config}"
 };
 
 // A custom attribute that is not explicitly modeled in a resource, e.g.

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

@@ -21,7 +21,7 @@ import "google/api/resource.proto";
 import "google/protobuf/struct.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
-option go_package = "google.golang.org/genproto/googleapis/cloud/discoveryengine/v1beta;discoveryengine";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
 option java_multiple_files = true;
 option java_outer_classname = "DocumentProto";
 option java_package = "com.google.cloud.discoveryengine.v1beta";
@@ -35,6 +35,7 @@ message Document {
   option (google.api.resource) = {
     type: "discoveryengine.googleapis.com/Document"
     pattern: "projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}"
+    pattern: "projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}"
   };
 
   // Data representation. One of
@@ -53,7 +54,7 @@ message Document {
 
   // Immutable. The full resource name of the document.
   // Format:
-  // `projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document_id}`.
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document_id}`.
   //
   // This field must be a UTF-8 encoded string with a length limit of 1024
   // characters.
@@ -65,8 +66,8 @@ message Document {
   // standard with a length limit of 63 characters.
   string id = 2 [(google.api.field_behavior) = IMMUTABLE];
 
-  // Required. The identifier of the schema located in the same data store.
-  string schema_id = 3 [(google.api.field_behavior) = REQUIRED];
+  // The identifier of the schema located in the same data store.
+  string schema_id = 3;
 
   // The identifier of the parent document. Currently supports at most two level
   // document hierarchy.

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

@@ -26,7 +26,7 @@ import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
-option go_package = "google.golang.org/genproto/googleapis/cloud/discoveryengine/v1beta;discoveryengine";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
 option java_multiple_files = true;
 option java_outer_classname = "DocumentServiceProto";
 option java_package = "com.google.cloud.discoveryengine.v1beta";
@@ -46,6 +46,9 @@ service DocumentService {
   rpc GetDocument(GetDocumentRequest) returns (Document) {
     option (google.api.http) = {
       get: "/v1beta/{name=projects/*/locations/*/dataStores/*/branches/*/documents/*}"
+      additional_bindings {
+        get: "/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*}"
+      }
     };
     option (google.api.method_signature) = "name";
   }
@@ -54,6 +57,9 @@ service DocumentService {
   rpc ListDocuments(ListDocumentsRequest) returns (ListDocumentsResponse) {
     option (google.api.http) = {
       get: "/v1beta/{parent=projects/*/locations/*/dataStores/*/branches/*}/documents"
+      additional_bindings {
+        get: "/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*/branches/*}/documents"
+      }
     };
     option (google.api.method_signature) = "parent";
   }
@@ -63,6 +69,10 @@ service DocumentService {
     option (google.api.http) = {
       post: "/v1beta/{parent=projects/*/locations/*/dataStores/*/branches/*}/documents"
       body: "document"
+      additional_bindings {
+        post: "/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*/branches/*}/documents"
+        body: "document"
+      }
     };
     option (google.api.method_signature) = "parent,document,document_id";
   }
@@ -72,6 +82,10 @@ service DocumentService {
     option (google.api.http) = {
       patch: "/v1beta/{document.name=projects/*/locations/*/dataStores/*/branches/*/documents/*}"
       body: "document"
+      additional_bindings {
+        patch: "/v1beta/{document.name=projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*}"
+        body: "document"
+      }
     };
   }
 
@@ -79,6 +93,9 @@ service DocumentService {
   rpc DeleteDocument(DeleteDocumentRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1beta/{name=projects/*/locations/*/dataStores/*/branches/*/documents/*}"
+      additional_bindings {
+        delete: "/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*}"
+      }
     };
     option (google.api.method_signature) = "name";
   }
@@ -95,6 +112,10 @@ service DocumentService {
     option (google.api.http) = {
       post: "/v1beta/{parent=projects/*/locations/*/dataStores/*/branches/*}/documents:import"
       body: "*"
+      additional_bindings {
+        post: "/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*/branches/*}/documents:import"
+        body: "*"
+      }
     };
     option (google.longrunning.operation_info) = {
       response_type: "google.cloud.discoveryengine.v1beta.ImportDocumentsResponse"
@@ -109,7 +130,7 @@ service DocumentService {
 message GetDocumentRequest {
   // Required. Full resource name of
   // [Document][google.cloud.discoveryengine.v1beta.Document], such as
-  // `projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}`.
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`.
   //
   // If the caller does not have permission to access the
   // [Document][google.cloud.discoveryengine.v1beta.Document], regardless of
@@ -130,7 +151,7 @@ message GetDocumentRequest {
 // method.
 message ListDocumentsRequest {
   // Required. The parent branch resource name, such as
-  // `projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}`.
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
   // Use `default_branch` as the branch ID, to list documents under the default
   // branch.
   //
@@ -183,7 +204,7 @@ message ListDocumentsResponse {
 // method.
 message CreateDocumentRequest {
   // Required. The parent resource name, such as
-  // `projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}`.
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -244,7 +265,7 @@ message UpdateDocumentRequest {
 message DeleteDocumentRequest {
   // Required. Full resource name of
   // [Document][google.cloud.discoveryengine.v1beta.Document], such as
-  // `projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}`.
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`.
   //
   // If the caller does not have permission to delete the
   // [Document][google.cloud.discoveryengine.v1beta.Document], regardless of

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

@@ -25,7 +25,7 @@ import "google/rpc/status.proto";
 import "google/type/date.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
-option go_package = "google.golang.org/genproto/googleapis/cloud/discoveryengine/v1beta;discoveryengine";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
 option java_multiple_files = true;
 option java_outer_classname = "ImportConfigProto";
 option java_package = "com.google.cloud.discoveryengine.v1beta";
@@ -33,10 +33,9 @@ option objc_class_prefix = "DISCOVERYENGINE";
 option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1beta";
 option ruby_package = "Google::Cloud::DiscoveryEngine::V1beta";
 
-// Google Cloud Storage location for input content.
-// format.
+// Cloud Storage location for input content.
 message GcsSource {
-  // Required. Google Cloud Storage URIs to input files. URI can be up to
+  // Required. Cloud Storage URIs to input files. 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`. A request can
@@ -45,16 +44,18 @@ message GcsSource {
 
   // The schema to use when parsing the data from the source.
   //
-  // Supported values for imports:
-  //
-  // * `user_event` (default): One JSON
-  // [UserEvent][google.cloud.discoveryengine.v1beta.UserEvent] per line.
+  // Supported values for document imports:
   //
   // * `document` (default): One JSON
   // [Document][google.cloud.discoveryengine.v1beta.Document] per line. Each
   // document must
   //   have a valid
   //   [Document.id][google.cloud.discoveryengine.v1beta.Document.id].
+  //
+  // Supported values for user even imports:
+  //
+  // * `user_event` (default): One JSON
+  // [UserEvent][google.cloud.discoveryengine.v1beta.UserEvent] per line.
   string data_schema = 2;
 }
 
@@ -102,7 +103,7 @@ message BigQuerySource {
 message ImportErrorConfig {
   // Required. Errors destination.
   oneof destination {
-    // Google Cloud Storage prefix for import errors. This must be an empty,
+    // Cloud Storage prefix for import errors. This must be an empty,
     // existing Cloud Storage directory. Import errors will be written to
     // sharded files in this directory, one per line, as a JSON-encoded
     // `google.rpc.Status` message.
@@ -123,7 +124,7 @@ message ImportUserEventsRequest {
     // Required. The Inline source for the input content for UserEvents.
     InlineSource inline_source = 2 [(google.api.field_behavior) = REQUIRED];
 
-    // Required. Google Cloud Storage location for the input content.
+    // Required. Cloud Storage location for the input content.
     GcsSource gcs_source = 3 [(google.api.field_behavior) = REQUIRED];
 
     // Required. BigQuery input source.
@@ -131,7 +132,7 @@ message ImportUserEventsRequest {
   }
 
   // Required. Parent DataStore resource name, of the form
-  // `projects/{project}/locations/{location}/dataStores/{data_store}`
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -226,7 +227,7 @@ message ImportDocumentsRequest {
     // The Inline source for the input content for documents.
     InlineSource inline_source = 2;
 
-    // Google Cloud Storage location for the input content.
+    // Cloud Storage location for the input content.
     GcsSource gcs_source = 3;
 
     // BigQuery input source.
@@ -234,7 +235,7 @@ message ImportDocumentsRequest {
   }
 
   // Required. The parent branch resource name, such as
-  // `projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}`.
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
   // Requires create/update permission.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,

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

@@ -25,7 +25,7 @@ import "google/cloud/discoveryengine/v1beta/user_event.proto";
 import "google/protobuf/struct.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
-option go_package = "google.golang.org/genproto/googleapis/cloud/discoveryengine/v1beta;discoveryengine";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
 option java_multiple_files = true;
 option java_outer_classname = "RecommendationServiceProto";
 option java_package = "com.google.cloud.discoveryengine.v1beta";
@@ -44,6 +44,10 @@ service RecommendationService {
     option (google.api.http) = {
       post: "/v1beta/{serving_config=projects/*/locations/*/dataStores/*/servingConfigs/*}:recommend"
       body: "*"
+      additional_bindings {
+        post: "/v1beta/{serving_config=projects/*/locations/*/collections/*/dataStores/*/servingConfigs/*}:recommend"
+        body: "*"
+      }
     };
   }
 }
@@ -51,7 +55,7 @@ service RecommendationService {
 // Request message for Recommend method.
 message RecommendRequest {
   // Required. Full resource name of the format:
-  // projects/*/locations/global/dataStores/*/servingConfigs/*
+  // projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*
   //
   // Before you can request recommendations from your model, you must create at
   // least one serving config  for it.
@@ -152,8 +156,8 @@ message RecommendRequest {
   //   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)
+  // See [Requirements for
+  // labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
   // for more details.
   map<string, string> user_labels = 8;
 }

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

@@ -23,7 +23,7 @@ import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
-option go_package = "google.golang.org/genproto/googleapis/cloud/discoveryengine/v1beta;discoveryengine";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
 option java_multiple_files = true;
 option java_outer_classname = "UserEventProto";
 option java_package = "com.google.cloud.discoveryengine.v1beta";
@@ -31,12 +31,13 @@ option objc_class_prefix = "DISCOVERYENGINE";
 option php_namespace = "Google\\Cloud\\DiscoveryEngine\\V1beta";
 option ruby_package = "Google::Cloud::DiscoveryEngine::V1beta";
 
-// UserEvent captures all metadata information DiscoveryEngine API needs to know
-// about how end users interact with customers' website.
+// UserEvent captures all metadata information Discovery Engine API needs to
+// know about how end users interact with customers' website.
 message UserEvent {
   // Required. User event type. Allowed values are:
   //
   // Generic values:
+  //
   // * `search`: Search for Documents.
   // * `view-item`: Detailed page view of a Document.
   // * `view-item-list`: View of a panel or ordered list of Documents.
@@ -44,10 +45,12 @@ message UserEvent {
   // * `view-category-page`: View of a category page, e.g. Home > Men > Jeans
   //
   // Retail-related values:
+  //
   // * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping
   // * `purchase`: Purchase an item(s)
   //
   // Media-related values:
+  //
   // * `media-play`: Start/resume watching a video, playing a song, etc.
   // * `media-complete`: Finished or stopped midway through a video, song, etc.
   string event_type = 1 [(google.api.field_behavior) = REQUIRED];
@@ -96,7 +99,8 @@ message UserEvent {
   // 128 bytes. A session is an aggregation of an end user behavior in a time
   // span.
   //
-  // A general guideline to populate the sesion_id:
+  // A general guideline to populate the session_id:
+  //
   // 1. If user has no activity for 30 min, a new session_id should be assigned.
   // 2. The session_id should be unique across users, suggest use uuid or add
   // [UserEvent.user_pseudo_id][google.cloud.discoveryengine.v1beta.UserEvent.user_pseudo_id]
@@ -199,7 +203,7 @@ message UserEvent {
   // If you provide custom attributes for ingested user events, also include
   // them in the user events that you associate with prediction requests. Custom
   // attribute formatting must be consistent between imported events and events
-  // provided with prediction requests. This lets the DiscoveryEngine API use
+  // provided with prediction requests. This lets the Discovery Engine API use
   // those custom attributes when training models and serving predictions, which
   // helps improve recommendation quality.
   //
@@ -377,19 +381,20 @@ message DocumentInfo {
   // A required descriptor of the associated Document.
   //
   // * If [id][google.cloud.discoveryengine.v1beta.DocumentInfo.id] is
-  // specified, then the default values for <location>, <data_store_id>, and
-  // <branch_id> are used when annotating with the stored Document.
+  // specified, then the default values for {location}, {collection_id},
+  // {data_store_id}, and {branch_id} are used when annotating with the stored
+  // Document.
   //
   // * If [name][google.cloud.discoveryengine.v1beta.DocumentInfo.name] is
   // specified, then the provided values (default values allowed) for
-  // <location>, <data_store_id>, and <branch_id> are used when annotating with
-  // the stored Document.
+  // {location}, {collection_id}, {data_store_id}, and {branch_id} are used when
+  // annotating with the stored Document.
   oneof document_descriptor {
     // Required. The Document resource ID.
     string id = 1 [(google.api.field_behavior) = REQUIRED];
 
     // Required. The Document resource full name, of the form:
-    // projects/<project_id>/locations/<location>/dataStores/<data_store_id>/branches/<branch_id>/documents/<document_id>
+    // projects/{project\_id}/locations/{location}/collections/{collection\_id}/dataStores/{data\_store\_id}/branches/{branch\_id}/documents/{document\_id}
     string name = 2 [
       (google.api.field_behavior) = REQUIRED,
       (google.api.resource_reference) = {
@@ -404,6 +409,7 @@ message DocumentInfo {
   // are involved in a `add-to-cart` event.
   //
   // Required for events of the following event types:
+  //
   // * `add-to-cart`
   // * `purchase`
   optional int32 quantity = 3;

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

@@ -26,7 +26,7 @@ import "google/cloud/discoveryengine/v1beta/user_event.proto";
 import "google/longrunning/operations.proto";
 
 option csharp_namespace = "Google.Cloud.DiscoveryEngine.V1Beta";
-option go_package = "google.golang.org/genproto/googleapis/cloud/discoveryengine/v1beta;discoveryengine";
+option go_package = "cloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb";
 option java_multiple_files = true;
 option java_outer_classname = "UserEventServiceProto";
 option java_package = "com.google.cloud.discoveryengine.v1beta";
@@ -45,6 +45,10 @@ service UserEventService {
     option (google.api.http) = {
       post: "/v1beta/{parent=projects/*/locations/*/dataStores/*}/userEvents:write"
       body: "user_event"
+      additional_bindings {
+        post: "/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/userEvents:write"
+        body: "user_event"
+      }
     };
   }
 
@@ -56,6 +60,9 @@ service UserEventService {
   rpc CollectUserEvent(CollectUserEventRequest) returns (google.api.HttpBody) {
     option (google.api.http) = {
       get: "/v1beta/{parent=projects/*/locations/*/dataStores/*}/userEvents:collect"
+      additional_bindings {
+        get: "/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/userEvents:collect"
+      }
     };
   }
 
@@ -71,6 +78,10 @@ service UserEventService {
     option (google.api.http) = {
       post: "/v1beta/{parent=projects/*/locations/*/dataStores/*}/userEvents:import"
       body: "*"
+      additional_bindings {
+        post: "/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/userEvents:import"
+        body: "*"
+      }
     };
     option (google.longrunning.operation_info) = {
       response_type: "google.cloud.discoveryengine.v1beta.ImportUserEventsResponse"
@@ -82,7 +93,7 @@ service UserEventService {
 // Request message for WriteUserEvent method.
 message WriteUserEventRequest {
   // Required. The parent DataStore resource name, such as
-  // `projects/{project}/locations/{location}/dataStores/{data_store}`.
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -97,7 +108,7 @@ message WriteUserEventRequest {
 // Request message for CollectUserEvent method.
 message CollectUserEventRequest {
   // Required. The parent DataStore resource name, such as
-  // `projects/{project}/locations/{location}/dataStores/{data_store}`.
+  // `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {