feat: Added TextSearch support to the batch search API

Google APIs · copybara-github · commit d6a2197c8c94 · 2025-11-20T01:14:59.000-08:00
docs: Added clarification of expected format of collection and index fields

PiperOrigin-RevId: 834645993
diff --git a/google/cloud/vectorsearch/v1beta/BUILD.bazel b/google/cloud/vectorsearch/v1beta/BUILD.bazel
@@ -313,9 +313,7 @@ ruby_grpc_library(
 ruby_cloud_gapic_library(
     name = "vectorsearch_ruby_gapic",
     srcs = [":vectorsearch_proto_with_info"],
-    extra_protoc_parameters = [
-        "ruby-cloud-gem-name=google-cloud-vectorsearch-v1beta",
-    ],
+    extra_protoc_parameters = ["ruby-cloud-gem-name=google-cloud-vectorsearch-v1beta"],
     grpc_service_config = "vectorsearch_v1beta_grpc_service_config.json",
     rest_numeric_enums = True,
     service_yaml = "vectorsearch_v1beta.yaml",
@@ -350,7 +348,6 @@ load(
 
 csharp_proto_library(
     name = "vectorsearch_csharp_proto",
-    extra_opts = [],
     deps = [":vectorsearch_proto"],
 )
 
diff --git a/google/cloud/vectorsearch/v1beta/data_object_search_service.proto b/google/cloud/vectorsearch/v1beta/data_object_search_service.proto
@@ -125,6 +125,9 @@ message Search {
 
     // A semantic search.
     SemanticSearch semantic_search = 2;
+
+    // A text search operation.
+    TextSearch text_search = 3;
   }
 }
 
@@ -176,6 +179,10 @@ message SemanticSearch {
   // 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];
 }
diff --git a/google/cloud/vectorsearch/v1beta/vectorsearch_service.proto b/google/cloud/vectorsearch/v1beta/vectorsearch_service.proto
@@ -192,11 +192,14 @@ message Collection {
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
   // Optional. Schema for vector fields. Only vector fields in this schema will
-  // be searchable.
+  // be searchable. Field names must contain only alphanumeric characters,
+  // underscores, and hyphens.
   map<string, VectorField> vector_schema = 7
       [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. JSON Schema for data.
+  // Field names must contain only alphanumeric characters,
+  // underscores, and hyphens.
   google.protobuf.Struct data_schema = 10
       [(google.api.field_behavior) = OPTIONAL];
 }
@@ -285,9 +288,11 @@ message CreateCollectionRequest {
     }
   ];
 
-  // Required. Id of the requesting object
-  // If auto-generating Id server-side, remove this field and
-  // collection_id from the method_signature of Create RPC
+  // Required. ID of the Collection 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 collection_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The resource being created
@@ -441,9 +446,11 @@ message CreateIndexRequest {
     }
   ];
 
-  // Required. Id of the requesting object
-  // If auto-generating Id server-side, remove this field and
-  // index_id from the method_signature of Create RPC
+  // Required. ID of the Index 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 index_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The resource being created
diff --git a/google/cloud/vectorsearch/v1beta/vectorsearch_v1beta.yaml b/google/cloud/vectorsearch/v1beta/vectorsearch_v1beta.yaml
@@ -76,7 +76,7 @@ authentication:
 
 publishing:
   new_issue_uri: https://issuetracker.google.com/issues/new?component=1899904
-  documentation_uri: https://docs.cloud.google.com/vertex-ai/docs/vector-search/overview
+  documentation_uri: https://docs.cloud.google.com/vertex-ai/docs/vector-search-2/overview
   api_short_name: vectorsearch
   github_label: 'api: vectorsearch'
   doc_tag_prefix: vectorsearch

Original file line number	Diff line number	Diff line change
`@@ -125,6 +125,9 @@ message Search {`
`125`	`125`
`126`	`126`	`// A semantic search.`
`127`	`127`	`SemanticSearch semantic_search = 2;`
	`128`	`+`
	`129`	`+ // A text search operation.`
	`130`	`+ TextSearch text_search = 3;`
`128`	`131`	`}`
`129`	`132`	`}`
`130`	`133`
`@@ -176,6 +179,10 @@ message SemanticSearch {`
`176`	`179`	`// Optional. The fields to return in the search results.`
`177`	`180`	`OutputFields output_fields = 3 [(google.api.field_behavior) = OPTIONAL];`
`178`	`181`
	`182`	`+ // Optional. A JSON filter expression, e.g. {"genre": {"$eq": "sci-fi"}},`
	`183`	`+ // represented as a google.protobuf.Struct.`
	`184`	`+ google.protobuf.Struct filter = 6 [(google.api.field_behavior) = OPTIONAL];`
	`185`	`+`
`179`	`186`	`// Optional. The number of data objects to return.`
`180`	`187`	`optional int32 top_k = 4 [(google.api.field_behavior) = OPTIONAL];`
`181`	`188`	`}`