feat: enable safe search feature for site search

Google APIs · copybara-github · commit 1392f6705490 · 2023-05-10T13:32:24.000-07:00
feat: allow users to provide user info in search
feat: allow users to provide additional labels in search

PiperOrigin-RevId: 530991570
diff --git a/google/cloud/discoveryengine/v1beta/search_service.proto b/google/cloud/discoveryengine/v1beta/search_service.proto
@@ -382,6 +382,11 @@ message SearchRequest {
   // If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
   string order_by = 8;
 
+  // Information about the end user.
+  // Highly recommended for analytics. The user_agent string in UserInfo will
+  // be used to deduce device_type for analytics.
+  UserInfo user_info = 21;
+
   // Facet specifications for faceted search. If empty, no facets are returned.
   //
   // A maximum of 100 values are allowed. Otherwise, an  `INVALID_ARGUMENT`
@@ -402,7 +407,6 @@ message SearchRequest {
   // * `search_type`: double. Default empty. Enables non-webpage searching
   //   depending on the value. The only valid non-default value is 1,
   //   which enables image searching.
-  // This field is ignored for other verticals.
   map<string, google.protobuf.Value> params = 11;
 
   // The query expansion specification that specifies the conditions under which
@@ -432,6 +436,29 @@ message SearchRequest {
   // The content search spec that configs the desired behavior of content
   // search.
   ContentSearchSpec content_search_spec = 24;
+
+  // Whether to turn on safe search. This is only supported for
+  // [ContentConfig.PUBLIC_WEBSITE][].
+  bool safe_search = 20;
+
+  // The user labels applied to a resource must meet the following requirements:
+  //
+  // * Each resource can have multiple labels, up to a maximum of 64.
+  // * Each label must be a key-value pair.
+  // * Keys have a minimum length of 1 character and a maximum length of 63
+  //   characters and cannot be empty. Values can be empty and have a maximum
+  //   length of 63 characters.
+  // * Keys and values can contain only lowercase letters, numeric characters,
+  //   underscores, and dashes. All characters must use UTF-8 encoding, and
+  //   international characters are allowed.
+  // * The key portion of a label must be unique. However, you can use the same
+  //   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)
+  // for more details.
+  map<string, string> user_label = 22;
 }
 
 // Response message for
