@google-cloud/vectorsearch 0.1.0

package/build/protos/google/cloud/vectorsearch/v1beta/data_object_search_service.proto

@@ -0,0 +1,428 @@
+// Copyright 2025 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.vectorsearch.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/vectorsearch/v1beta/common.proto";
+import "google/cloud/vectorsearch/v1beta/data_object.proto";
+import "google/cloud/vectorsearch/v1beta/embedding_config.proto";
+import "google/protobuf/struct.proto";
+
+option go_package = "cloud.google.com/go/vectorsearch/apiv1beta/vectorsearchpb;vectorsearchpb";
+option java_multiple_files = true;
+option java_outer_classname = "DataObjectSearchServiceProto";
+option java_package = "com.google.cloud.vectorsearch.v1beta";
+
+// Service for searching data objects.
+service DataObjectSearchService {
+  option (google.api.default_host) = "vectorsearch.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Searches data objects.
+  rpc SearchDataObjects(SearchDataObjectsRequest)
+      returns (SearchDataObjectsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/collections/*}/dataObjects:search"
+      body: "*"
+    };
+  }
+
+  // Queries data objects.
+  rpc QueryDataObjects(QueryDataObjectsRequest)
+      returns (QueryDataObjectsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/collections/*}/dataObjects:query"
+      body: "*"
+    };
+  }
+
+  // Aggregates data objects.
+  rpc AggregateDataObjects(AggregateDataObjectsRequest)
+      returns (AggregateDataObjectsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/collections/*}/dataObjects:aggregate"
+      body: "*"
+    };
+  }
+
+  // Batch searches data objects.
+  rpc BatchSearchDataObjects(BatchSearchDataObjectsRequest)
+      returns (BatchSearchDataObjectsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/collections/*}/dataObjects:batchSearch"
+      body: "*"
+    };
+  }
+}
+
+// Aggregation methods.
+enum AggregationMethod {
+  // Should not be used.
+  AGGREGATION_METHOD_UNSPECIFIED = 0;
+
+  // Count the number of data objects that match the filter.
+  COUNT = 1;
+}
+
+// Defines a output fields struct for data in DataObject.
+message OutputFields {
+  // Optional. The fields from the data fields to include in the output.
+  repeated string data_fields = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The fields from the vector fields to include in the output.
+  repeated string vector_fields = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The fields from the DataObject metadata to include in the output.
+  repeated string metadata_fields = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Represents a hint to the search index engine.
+message SearchHint {
+  // Message to specify the index to use for the search.
+  message IndexHint {
+    // Required. The resource name of the index to use for the search.
+    // The index must be in the same project, location, and collection.
+    // Format:
+    // `projects/{project}/locations/{location}/collections/{collection}/indexes/{index}`
+    string name = 1 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // The type of index to use.
+  oneof index_type {
+    // Specifies that the search should use a particular index.
+    IndexHint use_index = 1;
+
+    // If set to true, the search will use the system's default
+    // K-Nearest Neighbor (KNN) index engine.
+    bool use_knn = 2;
+  }
+}
+
+// A single search request within a batch operation.
+message Search {
+  // The type of search to perform.
+  oneof search_type {
+    // A vector-based search.
+    VectorSearch vector_search = 1;
+
+    // A semantic search.
+    SemanticSearch semantic_search = 2;
+
+    // A text search operation.
+    TextSearch text_search = 3;
+  }
+}
+
+// Defines a search operation using a query vector.
+message VectorSearch {
+  oneof vector_type {
+    // A dense vector for the query.
+    DenseVector vector = 1;
+
+    // A sparse vector for the query.
+    SparseVector sparse_vector = 2;
+  }
+
+  // Required. The vector field to search.
+  string search_field = 8 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
+  // represented as a google.protobuf.Struct.
+  google.protobuf.Struct filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The number of nearest neighbors to return.
+  optional int32 top_k = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Mask specifying which fields to return.
+  OutputFields output_fields = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Sets the search hint. If no strategy is specified, the service
+  // will use an index if one is available, and fall back to the default KNN
+  // search otherwise.
+  SearchHint search_hint = 9 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The distance metric to use for the KNN search. If not specified,
+  // DOT_PRODUCT will be used as the default.
+  DistanceMetric distance_metric = 11 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Defines a semantic search operation.
+message SemanticSearch {
+  // Required. The query text, which is used to generate an embedding according
+  // to the embedding model specified in the collection config.
+  string search_text = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The vector field to search.
+  string search_field = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The task type of the query embedding.
+  EmbeddingTaskType task_type = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The fields to return in the search results.
+  OutputFields output_fields = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
+  // represented as a google.protobuf.Struct.
+  google.protobuf.Struct filter = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The number of data objects to return.
+  optional int32 top_k = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Defines a text search operation.
+message TextSearch {
+  // Required. The query text.
+  string search_text = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The data field names to search.
+  repeated string data_field_names = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The fields to return in the search results.
+  OutputFields output_fields = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The number of results to return.
+  optional int32 top_k = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request for performing a single search.
+message SearchDataObjectsRequest {
+  // The query to search for.
+  oneof search_type {
+    // A vector search operation.
+    VectorSearch vector_search = 2;
+
+    // A semantic search operation.
+    SemanticSearch semantic_search = 4;
+
+    // Optional. A text search operation.
+    TextSearch text_search = 7 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Required. The resource name of the Collection for which to search.
+  // Format: `projects/{project}/locations/{location}/collections/{collection}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/Collection"
+    }
+  ];
+
+  // Optional. The standard list page size.
+  int32 page_size = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The standard list page token.
+  // Typically obtained via
+  // [SearchDataObjectsResponse.next_page_token][google.cloud.vectorsearch.v1beta.SearchDataObjectsResponse.next_page_token]
+  // of the previous
+  // [DataObjectSearchService.SearchDataObjects][google.cloud.vectorsearch.v1beta.DataObjectSearchService.SearchDataObjects]
+  // call.
+  string page_token = 6 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A single search result.
+message SearchResult {
+  // Output only. The matching data object.
+  DataObject data_object = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The similarity distance.
+  optional double distance = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Metadata about the search execution.
+message SearchResponseMetadata {
+  // Message that indicates the index used for the search.
+  message IndexInfo {
+    // Output only. The resource name of the index used for the search.
+    // Format:
+    // `projects/{project}/locations/{location}/collections/{collection}/indexes/{index}`
+    string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // The type of index used.
+  oneof index_type {
+    // Indicates that the search used a particular index.
+    IndexInfo used_index = 1;
+
+    // Output only. If true, the search used the system's default
+    // K-Nearest Neighbor (KNN) index engine.
+    bool used_knn = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+}
+
+// Response for a search request.
+message SearchDataObjectsResponse {
+  // Output only. The list of dataObjects that match the search criteria.
+  repeated SearchResult results = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. A token to retrieve next page of results.
+  // Pass to [DataObjectSearchService.SearchDataObjectsRequest.page_token][] to
+  // obtain that page.
+  string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Metadata about the search execution.
+  SearchResponseMetadata search_response_metadata = 3
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Request message for
+// [DataObjectSearchService.AggregateDataObjects][google.cloud.vectorsearch.v1beta.DataObjectSearchService.AggregateDataObjects].
+message AggregateDataObjectsRequest {
+  // Required. The resource name of the Collection for which to query.
+  // Format: `projects/{project}/locations/{location}/collections/{collection}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/Collection"
+    }
+  ];
+
+  // Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
+  // represented as a google.protobuf.Struct.
+  google.protobuf.Struct filter = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The aggregation method to apply to the query.
+  AggregationMethod aggregate = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for
+// [DataObjectSearchService.AggregateDataObjects][google.cloud.vectorsearch.v1beta.DataObjectSearchService.AggregateDataObjects].
+message AggregateDataObjectsResponse {
+  // The aggregated results of the query.
+  repeated google.protobuf.Struct aggregate_results = 1;
+}
+
+// Request message for
+// [DataObjectSearchService.QueryDataObjects][google.cloud.vectorsearch.v1beta.DataObjectSearchService.QueryDataObjects].
+message QueryDataObjectsRequest {
+  // Required. The resource name of the Collection for which to query.
+  // Format: `projects/{project}/locations/{location}/collections/{collection}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/Collection"
+    }
+  ];
+
+  // Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},
+  // represented as a google.protobuf.Struct.
+  google.protobuf.Struct filter = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Mask specifying which fields to return.
+  OutputFields output_fields = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The standard list page size.
+  int32 page_size = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The standard list page token.
+  // Typically obtained via
+  // [QueryDataObjectsResponse.next_page_token][google.cloud.vectorsearch.v1beta.QueryDataObjectsResponse.next_page_token]
+  // of the previous
+  // [DataObjectSearchService.QueryDataObjects][google.cloud.vectorsearch.v1beta.DataObjectSearchService.QueryDataObjects]
+  // call.
+  string page_token = 6 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for
+// [DataObjectSearchService.QueryDataObjects][google.cloud.vectorsearch.v1beta.DataObjectSearchService.QueryDataObjects].
+message QueryDataObjectsResponse {
+  // The list of dataObjects that match the query.
+  repeated DataObject data_objects = 4;
+
+  // A token to retrieve next page of results.
+  // Pass to [DataObjectSearchService.QueryDataObjectsRequest.page_token][] to
+  // obtain that page.
+  string next_page_token = 3;
+}
+
+// A request to perform a batch of search operations.
+message BatchSearchDataObjectsRequest {
+  // Options for combining the results of the batch search operations.
+  message CombineResultsOptions {
+    // Required. The ranker to use for combining the results.
+    Ranker ranker = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Optional. Mask specifying which fields to return.
+    OutputFields output_fields = 2 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The number of results to return. If not set, a default value
+    // will be used.
+    int32 top_k = 3 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Required. The resource name of the Collection for which to search.
+  // Format: `projects/{project}/locations/{location}/collections/{collection}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/Collection"
+    }
+  ];
+
+  // Required. A list of search requests to execute in parallel.
+  repeated Search searches = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Options for combining the results of the batch search operations.
+  CombineResultsOptions combine = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Defines a ranker to combine results from multiple searches.
+message Ranker {
+  // The ranking method to use.
+  oneof ranker {
+    // Reciprocal Rank Fusion ranking.
+    ReciprocalRankFusion rrf = 1;
+
+    // Vertex AI ranking.
+    VertexRanker vertex = 2;
+  }
+}
+
+// Defines the Reciprocal Rank Fusion (RRF) algorithm for result ranking.
+message ReciprocalRankFusion {
+  // Required. The weights to apply to each search result set during fusion.
+  repeated double weights = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Defines a ranker using the Vertex AI ranking service.
+// See https://cloud.google.com/generative-ai-app-builder/docs/ranking for
+// details.
+message VertexRanker {
+  // Required. The query against which the records are ranked and scored.
+  string query = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The template used to generate the record's title.
+  string title_template = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The template used to generate the record's content.
+  string content_template = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The model used for ranking documents. If no model is specified,
+  // then semantic-ranker-default@latest is used.
+  string model = 4 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A response from a batch search operation.
+message BatchSearchDataObjectsResponse {
+  // Output only. A list of search responses, one for each request in the batch.
+  // If a ranker is used, a single ranked list of results is returned.
+  repeated SearchDataObjectsResponse results = 1
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}

package/build/protos/google/cloud/vectorsearch/v1beta/data_object_service.proto

@@ -0,0 +1,233 @@
+// Copyright 2025 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.vectorsearch.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/vectorsearch/v1beta/data_object.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "cloud.google.com/go/vectorsearch/apiv1beta/vectorsearchpb;vectorsearchpb";
+option java_multiple_files = true;
+option java_outer_classname = "DataObjectServiceProto";
+option java_package = "com.google.cloud.vectorsearch.v1beta";
+
+// Service for creating and managing data objects.
+service DataObjectService {
+  option (google.api.default_host) = "vectorsearch.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates a dataObject.
+  rpc CreateDataObject(CreateDataObjectRequest) returns (DataObject) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/collections/*}/dataObjects"
+      body: "data_object"
+    };
+    option (google.api.method_signature) = "parent,data_object,data_object_id";
+  }
+
+  // Creates a batch of dataObjects.
+  rpc BatchCreateDataObjects(BatchCreateDataObjectsRequest)
+      returns (BatchCreateDataObjectsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/collections/*}/dataObjects:batchCreate"
+      body: "*"
+    };
+  }
+
+  // Gets a data object.
+  rpc GetDataObject(GetDataObjectRequest) returns (DataObject) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/locations/*/collections/*/dataObjects/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates a dataObject.
+  rpc UpdateDataObject(UpdateDataObjectRequest) returns (DataObject) {
+    option (google.api.http) = {
+      patch: "/v1beta/{data_object.name=projects/*/locations/*/collections/*/dataObjects/*}"
+      body: "data_object"
+    };
+    option (google.api.method_signature) = "data_object,update_mask";
+  }
+
+  // Updates dataObjects in a batch.
+  rpc BatchUpdateDataObjects(BatchUpdateDataObjectsRequest)
+      returns (BatchUpdateDataObjectsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/collections/*}/dataObjects:batchUpdate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,requests";
+  }
+
+  // Deletes a dataObject.
+  rpc DeleteDataObject(DeleteDataObjectRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta/{name=projects/*/locations/*/collections/*/dataObjects/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Deletes dataObjects in a batch.
+  rpc BatchDeleteDataObjects(BatchDeleteDataObjectsRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/collections/*}/dataObjects:batchDelete"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,requests";
+  }
+}
+
+// Request message for
+// [DataObjectService.CreateDataObject][google.cloud.vectorsearch.v1beta.DataObjectService.CreateDataObject].
+message CreateDataObjectRequest {
+  // Required. The resource name of the Collection to create the DataObject in.
+  // Format: `projects/{project}/locations/{location}/collections/{collection}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/Collection"
+    }
+  ];
+
+  // Required. The id of the dataObject to create.
+  // The id must be 1-63 characters long, and comply with
+  // <a href="https://www.ietf.org/rfc/rfc1035.txt" target="_blank">RFC1035</a>.
+  // Specifically, it must be 1-63 characters long and match the regular
+  // expression `[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?`.
+  string data_object_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The DataObject to create.
+  DataObject data_object = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for
+// [DataObjectService.BatchCreateDataObjects][google.cloud.vectorsearch.v1beta.DataObjectService.BatchCreateDataObjects].
+message BatchCreateDataObjectsRequest {
+  // Required. The resource name of the Collection to create the DataObjects in.
+  // Format: `projects/{project}/locations/{location}/collections/{collection}`.
+  // The parent field in the CreateDataObjectRequest messages must match this
+  // field.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/Collection"
+    }
+  ];
+
+  // Required. The request message specifying the resources to create.
+  // A maximum of 1000 DataObjects can be created in a batch.
+  repeated CreateDataObjectRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for
+// [DataObjectService.BatchCreateDataObjects][google.cloud.vectorsearch.v1beta.DataObjectService.BatchCreateDataObjects].
+message BatchCreateDataObjectsResponse {
+  // DataObjects created.
+  repeated DataObject data_objects = 1;
+}
+
+// Request message for
+// [DataObjectService.GetDataObject][google.cloud.vectorsearch.v1beta.DataObjectService.GetDataObject].
+message GetDataObjectRequest {
+  // Required. The name of the DataObject resource.
+  // Format:
+  // `projects/{project}/locations/{location}/collections/{collection}/dataObjects/{dataObject}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/DataObject"
+    }
+  ];
+}
+
+// Request message for
+// [DataObjectService.UpdateDataObject][google.cloud.vectorsearch.v1beta.DataObjectService.UpdateDataObject].
+message UpdateDataObjectRequest {
+  // Required. The DataObject which replaces the resource on the server.
+  DataObject data_object = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The update mask applies to the resource. See
+  // [google.protobuf.FieldMask][google.protobuf.FieldMask].
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request message for
+// [DataObjectService.BatchUpdateDataObjects][google.cloud.vectorsearch.v1beta.DataObjectService.BatchUpdateDataObjects].
+message BatchUpdateDataObjectsRequest {
+  // Required. The resource name of the Collection to update the DataObjects in.
+  // Format: `projects/{project}/locations/{location}/collections/{collection}`.
+  // The parent field in the UpdateDataObjectRequest messages must match this
+  // field.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/Collection"
+    }
+  ];
+
+  // Required. The request message specifying the resources to update.
+  // A maximum of 1000 DataObjects can be updated in a batch.
+  repeated UpdateDataObjectRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for
+// [DataObjectService.BatchUpdateDataObjects][google.cloud.vectorsearch.v1beta.DataObjectService.BatchUpdateDataObjects].
+message BatchUpdateDataObjectsResponse {}
+
+// Request message for
+// [DataObjectService.DeleteDataObject][google.cloud.vectorsearch.v1beta.DataObjectService.DeleteDataObject].
+message DeleteDataObjectRequest {
+  // Required. The name of the DataObject resource to be deleted.
+  // Format:
+  // `projects/{project}/locations/{location}/collections/{collection}/dataObjects/{dataObject}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/DataObject"
+    }
+  ];
+}
+
+// Request message for
+// [DataObjectService.BatchDeleteDataObjects][google.cloud.vectorsearch.v1beta.DataObjectService.BatchDeleteDataObjects].
+message BatchDeleteDataObjectsRequest {
+  // Required. The resource name of the Collection to delete the DataObjects in.
+  // Format: `projects/{project}/locations/{location}/collections/{collection}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vectorsearch.googleapis.com/Collection"
+    }
+  ];
+
+  // Required. The request message specifying the resources to delete.
+  // A maximum of 1000 DataObjects can be deleted in a batch.
+  repeated DeleteDataObjectRequest requests = 3
+      [(google.api.field_behavior) = REQUIRED];
+}