google-cloud-discovery_engine-v1beta 0.11.0 → 0.12.0

data/lib/google/cloud/discovery_engine/v1beta/user_event_service/operations.rb

@@ -26,6 +26,9 @@ module Google
         module UserEventService
           # Service that implements Longrunning Operations API.
           class Operations
+            # @private
+            API_VERSION = ""
+
             # @private
             DEFAULT_ENDPOINT_TEMPLATE = "discoveryengine.$UNIVERSE_DOMAIN$"
 
@@ -191,10 +194,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.list_operations.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
               metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
@@ -287,10 +291,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.get_operation.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
               metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
@@ -376,10 +381,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.delete_operation.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
               metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
@@ -470,10 +476,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.cancel_operation.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
               metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               header_params = {}
@@ -574,10 +581,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.wait_operation.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
               metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                 lib_name: @config.lib_name, lib_version: @config.lib_version,
                 gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
               options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,

data/lib/google/cloud/discovery_engine/v1beta/user_event_service/paths.rb

@@ -122,6 +122,27 @@ module Google
               resource.call(**args)
             end
 
+            ##
+            # Create a fully-qualified Engine resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param collection [String]
+            # @param engine [String]
+            #
+            # @return [::String]
+            def engine_path project:, location:, collection:, engine:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "collection cannot contain /" if collection.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/collections/#{collection}/engines/#{engine}"
+            end
+
             extend self
           end
         end

data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/client.rb

@@ -33,6 +33,9 @@ module Google
             # Service for ingesting end user actions on a website to Discovery Engine API.
             #
             class Client
+              # @private
+              API_VERSION = ""
+
               # @private
               DEFAULT_ENDPOINT_TEMPLATE = "discoveryengine.$UNIVERSE_DOMAIN$"
 
@@ -205,16 +208,27 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload write_user_event(parent: nil, user_event: nil)
+              # @overload write_user_event(parent: nil, user_event: nil, write_async: nil)
               #   Pass arguments to `write_user_event` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The parent DataStore resource name, such as
+              #     Required. The parent resource name.
+              #     If the write user event action is applied in
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::DataStore 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
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::Document Document} across multiple
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::DataStore DataStore}, the format is:
+              #     `projects/{project}/locations/{location}`.
               #   @param user_event [::Google::Cloud::DiscoveryEngine::V1beta::UserEvent, ::Hash]
               #     Required. User event to write.
+              #   @param write_async [::Boolean]
+              #     If set to true, the user event is written asynchronously after
+              #     validation, and the API responds without waiting for the write.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1beta::UserEvent]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -249,12 +263,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.write_user_event.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                   lib_name: @config.lib_name, lib_version: @config.lib_version,
                   gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.write_user_event.timeout,
@@ -344,12 +359,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.collect_user_event.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                   lib_name: @config.lib_name, lib_version: @config.lib_version,
                   gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.collect_user_event.timeout,
@@ -369,7 +385,7 @@ module Google
               end
 
               ##
-              # 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.
               #
@@ -445,12 +461,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.import_user_events.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                   lib_name: @config.lib_name, lib_version: @config.lib_version,
                   gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.import_user_events.timeout,

data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/operations.rb

@@ -26,6 +26,9 @@ module Google
           module Rest
             # Service that implements Longrunning Operations API.
             class Operations
+              # @private
+              API_VERSION = ""
+
               # @private
               DEFAULT_ENDPOINT_TEMPLATE = "discoveryengine.$UNIVERSE_DOMAIN$"
 
@@ -181,12 +184,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.list_operations.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                   lib_name: @config.lib_name, lib_version: @config.lib_version,
                   gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.list_operations.timeout,
@@ -269,12 +273,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.get_operation.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                   lib_name: @config.lib_name, lib_version: @config.lib_version,
                   gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.get_operation.timeout,
@@ -351,12 +356,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.delete_operation.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                   lib_name: @config.lib_name, lib_version: @config.lib_version,
                   gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.delete_operation.timeout,
@@ -438,12 +444,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.cancel_operation.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
                   lib_name: @config.lib_name, lib_version: @config.lib_version,
                   gapic_version: ::Google::Cloud::DiscoveryEngine::V1beta::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.cancel_operation.timeout,
@@ -1060,10 +1067,18 @@ module Google
                 transcoder = Gapic::Rest::GrpcTranscoder.new
                                                         .with_bindings(
                                                           uri_method: :post,
-                                                          uri_template: "/v1/{name}:cancel",
+                                                          uri_template: "/v1beta/{name}:cancel",
                                                           body: "*",
                                                           matches: [
-                                                            ["name", %r{^operations(?:/.*)?$}, true]
+                                                            ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/branches/[^/]+/operations/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1beta/{name}:cancel",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["name", %r{^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/branches/[^/]+/operations/[^/]+/?$}, false]
                                                           ]
                                                         )
                 transcoder.transcode request_pb

data/lib/google/cloud/discovery_engine/v1beta/user_event_service/rest/service_stub.rb

@@ -202,6 +202,14 @@ module Google
                                                             ["parent", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/?$}, false]
                                                           ]
                                                         )
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1beta/{parent}/userEvents:write",
+                                                          body: "user_event",
+                                                          matches: [
+                                                            ["parent", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
+                                                          ]
+                                                        )
                 transcoder.transcode request_pb
               end
 

data/lib/google/cloud/discovery_engine/v1beta/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module DiscoveryEngine
       module V1beta
-        VERSION = "0.11.0"
+        VERSION = "0.12.0"
       end
     end
   end

data/lib/google/cloud/discovery_engine/v1beta.rb

@@ -17,12 +17,14 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/discovery_engine/v1beta/completion_service"
+require "google/cloud/discovery_engine/v1beta/control_service"
 require "google/cloud/discovery_engine/v1beta/search_service"
 require "google/cloud/discovery_engine/v1beta/conversational_search_service"
 require "google/cloud/discovery_engine/v1beta/data_store_service"
 require "google/cloud/discovery_engine/v1beta/document_service"
 require "google/cloud/discovery_engine/v1beta/engine_service"
 require "google/cloud/discovery_engine/v1beta/grounded_generation_service"
+require "google/cloud/discovery_engine/v1beta/project_service"
 require "google/cloud/discovery_engine/v1beta/rank_service"
 require "google/cloud/discovery_engine/v1beta/recommendation_service"
 require "google/cloud/discovery_engine/v1beta/schema_service"

data/lib/google/cloud/discoveryengine/v1beta/answer_pb.rb

@@ -6,10 +6,11 @@ require 'google/protobuf'
 
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
 
 
-descriptor_data = "\n0google/cloud/discoveryengine/v1beta/answer.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xa0\x1e\n\x06\x41nswer\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x05\x12@\n\x05state\x18\x02 \x01(\x0e\x32\x31.google.cloud.discoveryengine.v1beta.Answer.State\x12\x13\n\x0b\x61nswer_text\x18\x03 \x01(\t\x12G\n\tcitations\x18\x04 \x03(\x0b\x32\x34.google.cloud.discoveryengine.v1beta.Answer.Citation\x12I\n\nreferences\x18\x05 \x03(\x0b\x32\x35.google.cloud.discoveryengine.v1beta.Answer.Reference\x12\x19\n\x11related_questions\x18\x06 \x03(\t\x12?\n\x05steps\x18\x07 \x03(\x0b\x32\x30.google.cloud.discoveryengine.v1beta.Answer.Step\x12\x64\n\x18query_understanding_info\x18\n \x01(\x0b\x32\x42.google.cloud.discoveryengine.v1beta.Answer.QueryUnderstandingInfo\x12_\n\x16\x61nswer_skipped_reasons\x18\x0b \x03(\x0e\x32?.google.cloud.discoveryengine.v1beta.Answer.AnswerSkippedReason\x12\x34\n\x0b\x63reate_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x36\n\rcomplete_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x1a\x7f\n\x08\x43itation\x12\x13\n\x0bstart_index\x18\x01 \x01(\x03\x12\x11\n\tend_index\x18\x02 \x01(\x03\x12K\n\x07sources\x18\x03 \x03(\x0b\x32:.google.cloud.discoveryengine.v1beta.Answer.CitationSource\x1a&\n\x0e\x43itationSource\x12\x14\n\x0creference_id\x18\x01 \x01(\t\x1a\x8d\x07\n\tReference\x12t\n\x1aunstructured_document_info\x18\x01 \x01(\x0b\x32N.google.cloud.discoveryengine.v1beta.Answer.Reference.UnstructuredDocumentInfoH\x00\x12U\n\nchunk_info\x18\x02 \x01(\x0b\x32?.google.cloud.discoveryengine.v1beta.Answer.Reference.ChunkInfoH\x00\x1a\xa5\x02\n\x18UnstructuredDocumentInfo\x12>\n\x08\x64ocument\x18\x01 \x01(\tB,\xfa\x41)\n\'discoveryengine.googleapis.com/Document\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12s\n\x0e\x63hunk_contents\x18\x04 \x03(\x0b\x32[.google.cloud.discoveryengine.v1beta.Answer.Reference.UnstructuredDocumentInfo.ChunkContent\x1a\x38\n\x0c\x43hunkContent\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x17\n\x0fpage_identifier\x18\x02 \x01(\t\x1a\xff\x02\n\tChunkInfo\x12\x38\n\x05\x63hunk\x18\x01 \x01(\tB)\xfa\x41&\n$discoveryengine.googleapis.com/Chunk\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x12\x1c\n\x0frelevance_score\x18\x03 \x01(\x02H\x00\x88\x01\x01\x12k\n\x11\x64ocument_metadata\x18\x04 \x01(\x0b\x32P.google.cloud.discoveryengine.v1beta.Answer.Reference.ChunkInfo.DocumentMetadata\x1a\x87\x01\n\x10\x44ocumentMetadata\x12>\n\x08\x64ocument\x18\x01 \x01(\tB,\xfa\x41)\n\'discoveryengine.googleapis.com/Document\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12\x17\n\x0fpage_identifier\x18\x04 \x01(\tB\x12\n\x10_relevance_scoreB\t\n\x07\x63ontent\x1a\xaa\x08\n\x04Step\x12\x45\n\x05state\x18\x01 \x01(\x0e\x32\x36.google.cloud.discoveryengine.v1beta.Answer.Step.State\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x0f\n\x07thought\x18\x03 \x01(\t\x12H\n\x07\x61\x63tions\x18\x04 \x03(\x0b\x32\x37.google.cloud.discoveryengine.v1beta.Answer.Step.Action\x1a\x9e\x06\n\x06\x41\x63tion\x12]\n\rsearch_action\x18\x02 \x01(\x0b\x32\x44.google.cloud.discoveryengine.v1beta.Answer.Step.Action.SearchActionH\x00\x12X\n\x0bobservation\x18\x03 \x01(\x0b\x32\x43.google.cloud.discoveryengine.v1beta.Answer.Step.Action.Observation\x1a\x1d\n\x0cSearchAction\x12\r\n\x05query\x18\x01 \x01(\t\x1a\xb1\x04\n\x0bObservation\x12h\n\x0esearch_results\x18\x02 \x03(\x0b\x32P.google.cloud.discoveryengine.v1beta.Answer.Step.Action.Observation.SearchResult\x1a\xb7\x03\n\x0cSearchResult\x12\x10\n\x08\x64ocument\x18\x01 \x01(\t\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12r\n\x0csnippet_info\x18\x04 \x03(\x0b\x32\\.google.cloud.discoveryengine.v1beta.Answer.Step.Action.Observation.SearchResult.SnippetInfo\x12n\n\nchunk_info\x18\x05 \x03(\x0b\x32Z.google.cloud.discoveryengine.v1beta.Answer.Step.Action.Observation.SearchResult.ChunkInfo\x1a\x36\n\x0bSnippetInfo\x12\x0f\n\x07snippet\x18\x01 \x01(\t\x12\x16\n\x0esnippet_status\x18\x02 \x01(\t\x1a]\n\tChunkInfo\x12\r\n\x05\x63hunk\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x12\x1c\n\x0frelevance_score\x18\x03 \x01(\x02H\x00\x88\x01\x01\x42\x12\n\x10_relevance_scoreB\x08\n\x06\x61\x63tion\"J\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIN_PROGRESS\x10\x01\x12\n\n\x06\x46\x41ILED\x10\x02\x12\r\n\tSUCCEEDED\x10\x03\x1a\x87\x03\n\x16QueryUnderstandingInfo\x12}\n\x19query_classification_info\x18\x01 \x03(\x0b\x32Z.google.cloud.discoveryengine.v1beta.Answer.QueryUnderstandingInfo.QueryClassificationInfo\x1a\xed\x01\n\x17QueryClassificationInfo\x12m\n\x04type\x18\x01 \x01(\x0e\x32_.google.cloud.discoveryengine.v1beta.Answer.QueryUnderstandingInfo.QueryClassificationInfo.Type\x12\x10\n\x08positive\x18\x02 \x01(\x08\"Q\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11\x41\x44VERSARIAL_QUERY\x10\x01\x12\x1c\n\x18NON_ANSWER_SEEKING_QUERY\x10\x02\"J\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIN_PROGRESS\x10\x01\x12\n\n\x06\x46\x41ILED\x10\x02\x12\r\n\tSUCCEEDED\x10\x03\"\xc2\x01\n\x13\x41nswerSkippedReason\x12%\n!ANSWER_SKIPPED_REASON_UNSPECIFIED\x10\x00\x12\x1d\n\x19\x41\x44VERSARIAL_QUERY_IGNORED\x10\x01\x12$\n NON_ANSWER_SEEKING_QUERY_IGNORED\x10\x02\x12\x1f\n\x1bOUT_OF_DOMAIN_QUERY_IGNORED\x10\x03\x12\x1e\n\x1aPOTENTIAL_POLICY_VIOLATION\x10\x04:\x85\x03\xea\x41\x81\x03\n%discoveryengine.googleapis.com/Answer\x12\x63projects/{project}/locations/{location}/dataStores/{data_store}/sessions/{session}/answers/{answer}\x12|projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/sessions/{session}/answers/{answer}\x12uprojects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/answers/{answer}B\x92\x02\n\'com.google.cloud.discoveryengine.v1betaB\x0b\x41nswerProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1betab\x06proto3"
+descriptor_data = "\n0google/cloud/discoveryengine/v1beta/answer.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xfc\x1e\n\x06\x41nswer\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x05\x12@\n\x05state\x18\x02 \x01(\x0e\x32\x31.google.cloud.discoveryengine.v1beta.Answer.State\x12\x13\n\x0b\x61nswer_text\x18\x03 \x01(\t\x12G\n\tcitations\x18\x04 \x03(\x0b\x32\x34.google.cloud.discoveryengine.v1beta.Answer.Citation\x12I\n\nreferences\x18\x05 \x03(\x0b\x32\x35.google.cloud.discoveryengine.v1beta.Answer.Reference\x12\x19\n\x11related_questions\x18\x06 \x03(\t\x12?\n\x05steps\x18\x07 \x03(\x0b\x32\x30.google.cloud.discoveryengine.v1beta.Answer.Step\x12\x64\n\x18query_understanding_info\x18\n \x01(\x0b\x32\x42.google.cloud.discoveryengine.v1beta.Answer.QueryUnderstandingInfo\x12_\n\x16\x61nswer_skipped_reasons\x18\x0b \x03(\x0e\x32?.google.cloud.discoveryengine.v1beta.Answer.AnswerSkippedReason\x12\x34\n\x0b\x63reate_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x36\n\rcomplete_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x1a\x7f\n\x08\x43itation\x12\x13\n\x0bstart_index\x18\x01 \x01(\x03\x12\x11\n\tend_index\x18\x02 \x01(\x03\x12K\n\x07sources\x18\x03 \x03(\x0b\x32:.google.cloud.discoveryengine.v1beta.Answer.CitationSource\x1a&\n\x0e\x43itationSource\x12\x14\n\x0creference_id\x18\x01 \x01(\t\x1a\xe9\x07\n\tReference\x12t\n\x1aunstructured_document_info\x18\x01 \x01(\x0b\x32N.google.cloud.discoveryengine.v1beta.Answer.Reference.UnstructuredDocumentInfoH\x00\x12U\n\nchunk_info\x18\x02 \x01(\x0b\x32?.google.cloud.discoveryengine.v1beta.Answer.Reference.ChunkInfoH\x00\x1a\xd3\x02\n\x18UnstructuredDocumentInfo\x12>\n\x08\x64ocument\x18\x01 \x01(\tB,\xfa\x41)\n\'discoveryengine.googleapis.com/Document\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12s\n\x0e\x63hunk_contents\x18\x04 \x03(\x0b\x32[.google.cloud.discoveryengine.v1beta.Answer.Reference.UnstructuredDocumentInfo.ChunkContent\x12,\n\x0bstruct_data\x18\x05 \x01(\x0b\x32\x17.google.protobuf.Struct\x1a\x38\n\x0c\x43hunkContent\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x17\n\x0fpage_identifier\x18\x02 \x01(\t\x1a\xad\x03\n\tChunkInfo\x12\x38\n\x05\x63hunk\x18\x01 \x01(\tB)\xfa\x41&\n$discoveryengine.googleapis.com/Chunk\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x12\x1c\n\x0frelevance_score\x18\x03 \x01(\x02H\x00\x88\x01\x01\x12k\n\x11\x64ocument_metadata\x18\x04 \x01(\x0b\x32P.google.cloud.discoveryengine.v1beta.Answer.Reference.ChunkInfo.DocumentMetadata\x1a\xb5\x01\n\x10\x44ocumentMetadata\x12>\n\x08\x64ocument\x18\x01 \x01(\tB,\xfa\x41)\n\'discoveryengine.googleapis.com/Document\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12\x17\n\x0fpage_identifier\x18\x04 \x01(\t\x12,\n\x0bstruct_data\x18\x05 \x01(\x0b\x32\x17.google.protobuf.StructB\x12\n\x10_relevance_scoreB\t\n\x07\x63ontent\x1a\xaa\x08\n\x04Step\x12\x45\n\x05state\x18\x01 \x01(\x0e\x32\x36.google.cloud.discoveryengine.v1beta.Answer.Step.State\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x0f\n\x07thought\x18\x03 \x01(\t\x12H\n\x07\x61\x63tions\x18\x04 \x03(\x0b\x32\x37.google.cloud.discoveryengine.v1beta.Answer.Step.Action\x1a\x9e\x06\n\x06\x41\x63tion\x12]\n\rsearch_action\x18\x02 \x01(\x0b\x32\x44.google.cloud.discoveryengine.v1beta.Answer.Step.Action.SearchActionH\x00\x12X\n\x0bobservation\x18\x03 \x01(\x0b\x32\x43.google.cloud.discoveryengine.v1beta.Answer.Step.Action.Observation\x1a\x1d\n\x0cSearchAction\x12\r\n\x05query\x18\x01 \x01(\t\x1a\xb1\x04\n\x0bObservation\x12h\n\x0esearch_results\x18\x02 \x03(\x0b\x32P.google.cloud.discoveryengine.v1beta.Answer.Step.Action.Observation.SearchResult\x1a\xb7\x03\n\x0cSearchResult\x12\x10\n\x08\x64ocument\x18\x01 \x01(\t\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12r\n\x0csnippet_info\x18\x04 \x03(\x0b\x32\\.google.cloud.discoveryengine.v1beta.Answer.Step.Action.Observation.SearchResult.SnippetInfo\x12n\n\nchunk_info\x18\x05 \x03(\x0b\x32Z.google.cloud.discoveryengine.v1beta.Answer.Step.Action.Observation.SearchResult.ChunkInfo\x1a\x36\n\x0bSnippetInfo\x12\x0f\n\x07snippet\x18\x01 \x01(\t\x12\x16\n\x0esnippet_status\x18\x02 \x01(\t\x1a]\n\tChunkInfo\x12\r\n\x05\x63hunk\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x12\x1c\n\x0frelevance_score\x18\x03 \x01(\x02H\x00\x88\x01\x01\x42\x12\n\x10_relevance_scoreB\x08\n\x06\x61\x63tion\"J\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIN_PROGRESS\x10\x01\x12\n\n\x06\x46\x41ILED\x10\x02\x12\r\n\tSUCCEEDED\x10\x03\x1a\x87\x03\n\x16QueryUnderstandingInfo\x12}\n\x19query_classification_info\x18\x01 \x03(\x0b\x32Z.google.cloud.discoveryengine.v1beta.Answer.QueryUnderstandingInfo.QueryClassificationInfo\x1a\xed\x01\n\x17QueryClassificationInfo\x12m\n\x04type\x18\x01 \x01(\x0e\x32_.google.cloud.discoveryengine.v1beta.Answer.QueryUnderstandingInfo.QueryClassificationInfo.Type\x12\x10\n\x08positive\x18\x02 \x01(\x08\"Q\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11\x41\x44VERSARIAL_QUERY\x10\x01\x12\x1c\n\x18NON_ANSWER_SEEKING_QUERY\x10\x02\"J\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIN_PROGRESS\x10\x01\x12\n\n\x06\x46\x41ILED\x10\x02\x12\r\n\tSUCCEEDED\x10\x03\"\xc2\x01\n\x13\x41nswerSkippedReason\x12%\n!ANSWER_SKIPPED_REASON_UNSPECIFIED\x10\x00\x12\x1d\n\x19\x41\x44VERSARIAL_QUERY_IGNORED\x10\x01\x12$\n NON_ANSWER_SEEKING_QUERY_IGNORED\x10\x02\x12\x1f\n\x1bOUT_OF_DOMAIN_QUERY_IGNORED\x10\x03\x12\x1e\n\x1aPOTENTIAL_POLICY_VIOLATION\x10\x04:\x85\x03\xea\x41\x81\x03\n%discoveryengine.googleapis.com/Answer\x12\x63projects/{project}/locations/{location}/dataStores/{data_store}/sessions/{session}/answers/{answer}\x12|projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/sessions/{session}/answers/{answer}\x12uprojects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/answers/{answer}B\x92\x02\n\'com.google.cloud.discoveryengine.v1betaB\x0b\x41nswerProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1betab\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 
@@ -25,6 +26,7 @@ rescue TypeError
   warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
   imports = [
     ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
+    ["google.protobuf.Struct", "google/protobuf/struct.proto"],
   ]
   imports.each do |type_name, expected_filename|
     import_file = pool.lookup(type_name).file_descriptor

data/lib/google/cloud/discoveryengine/v1beta/common_pb.rb

@@ -7,7 +7,7 @@ require 'google/protobuf'
 require 'google/api/resource_pb'
 
 
-descriptor_data = "\n0google/cloud/discoveryengine/v1beta/common.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x19google/api/resource.proto\"x\n\x08Interval\x12\x11\n\x07minimum\x18\x01 \x01(\x01H\x00\x12\x1b\n\x11\x65xclusive_minimum\x18\x02 \x01(\x01H\x00\x12\x11\n\x07maximum\x18\x03 \x01(\x01H\x01\x12\x1b\n\x11\x65xclusive_maximum\x18\x04 \x01(\x01H\x01\x42\x05\n\x03minB\x05\n\x03max\"0\n\x0f\x43ustomAttribute\x12\x0c\n\x04text\x18\x01 \x03(\t\x12\x0f\n\x07numbers\x18\x02 \x03(\x01\"/\n\x08UserInfo\x12\x0f\n\x07user_id\x18\x01 \x01(\t\x12\x12\n\nuser_agent\x18\x02 \x01(\t\"%\n\x0f\x45mbeddingConfig\x12\x12\n\nfield_path\x18\x01 \x01(\t\"\x1c\n\nDoubleList\x12\x0e\n\x06values\x18\x01 \x03(\x01*b\n\x10IndustryVertical\x12!\n\x1dINDUSTRY_VERTICAL_UNSPECIFIED\x10\x00\x12\x0b\n\x07GENERIC\x10\x01\x12\t\n\x05MEDIA\x10\x02\x12\x13\n\x0fHEALTHCARE_FHIR\x10\x07*\xa4\x01\n\x0cSolutionType\x12\x1d\n\x19SOLUTION_TYPE_UNSPECIFIED\x10\x00\x12 \n\x1cSOLUTION_TYPE_RECOMMENDATION\x10\x01\x12\x18\n\x14SOLUTION_TYPE_SEARCH\x10\x02\x12\x16\n\x12SOLUTION_TYPE_CHAT\x10\x03\x12!\n\x1dSOLUTION_TYPE_GENERATIVE_CHAT\x10\x04*_\n\nSearchTier\x12\x1b\n\x17SEARCH_TIER_UNSPECIFIED\x10\x00\x12\x18\n\x14SEARCH_TIER_STANDARD\x10\x01\x12\x1a\n\x16SEARCH_TIER_ENTERPRISE\x10\x02*C\n\x0bSearchAddOn\x12\x1d\n\x19SEARCH_ADD_ON_UNSPECIFIED\x10\x00\x12\x15\n\x11SEARCH_ADD_ON_LLM\x10\x01\x42\xe9\n\n\'com.google.cloud.discoveryengine.v1betaB\x0b\x43ommonProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1beta\xea\x41\xe6\x01\n%discoveryengine.googleapis.com/Branch\x12Qprojects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}\x12jprojects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}\xea\x41m\n)discoveryengine.googleapis.com/Collection\x12@projects/{project}/locations/{location}/collections/{collection}\xea\x41R\n\'discoveryengine.googleapis.com/Location\x12\'projects/{project}/locations/{location}\xea\x41}\n.discoveryengine.googleapis.com/GroundingConfig\x12Kprojects/{project}/locations/{location}/groundingConfigs/{grounding_config}\xea\x41w\n,discoveryengine.googleapis.com/RankingConfig\x12Gprojects/{project}/locations/{location}/rankingConfigs/{ranking_config}\xea\x41y\n#healthcare.googleapis.com/FhirStore\x12Rprojects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}\xea\x41\xae\x02\n$discoveryengine.googleapis.com/Chunk\x12uprojects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}/chunks/{chunk}\x12\x8e\x01projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}/chunks/{chunk}b\x06proto3"
+descriptor_data = "\n0google/cloud/discoveryengine/v1beta/common.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x19google/api/resource.proto\"x\n\x08Interval\x12\x11\n\x07minimum\x18\x01 \x01(\x01H\x00\x12\x1b\n\x11\x65xclusive_minimum\x18\x02 \x01(\x01H\x00\x12\x11\n\x07maximum\x18\x03 \x01(\x01H\x01\x12\x1b\n\x11\x65xclusive_maximum\x18\x04 \x01(\x01H\x01\x42\x05\n\x03minB\x05\n\x03max\"0\n\x0f\x43ustomAttribute\x12\x0c\n\x04text\x18\x01 \x03(\t\x12\x0f\n\x07numbers\x18\x02 \x03(\x01\"/\n\x08UserInfo\x12\x0f\n\x07user_id\x18\x01 \x01(\t\x12\x12\n\nuser_agent\x18\x02 \x01(\t\"%\n\x0f\x45mbeddingConfig\x12\x12\n\nfield_path\x18\x01 \x01(\t\"\x1c\n\nDoubleList\x12\x0e\n\x06values\x18\x01 \x03(\x01*b\n\x10IndustryVertical\x12!\n\x1dINDUSTRY_VERTICAL_UNSPECIFIED\x10\x00\x12\x0b\n\x07GENERIC\x10\x01\x12\t\n\x05MEDIA\x10\x02\x12\x13\n\x0fHEALTHCARE_FHIR\x10\x07*\xa4\x01\n\x0cSolutionType\x12\x1d\n\x19SOLUTION_TYPE_UNSPECIFIED\x10\x00\x12 \n\x1cSOLUTION_TYPE_RECOMMENDATION\x10\x01\x12\x18\n\x14SOLUTION_TYPE_SEARCH\x10\x02\x12\x16\n\x12SOLUTION_TYPE_CHAT\x10\x03\x12!\n\x1dSOLUTION_TYPE_GENERATIVE_CHAT\x10\x04*h\n\rSearchUseCase\x12\x1f\n\x1bSEARCH_USE_CASE_UNSPECIFIED\x10\x00\x12\x1a\n\x16SEARCH_USE_CASE_SEARCH\x10\x01\x12\x1a\n\x16SEARCH_USE_CASE_BROWSE\x10\x02*_\n\nSearchTier\x12\x1b\n\x17SEARCH_TIER_UNSPECIFIED\x10\x00\x12\x18\n\x14SEARCH_TIER_STANDARD\x10\x01\x12\x1a\n\x16SEARCH_TIER_ENTERPRISE\x10\x02*C\n\x0bSearchAddOn\x12\x1d\n\x19SEARCH_ADD_ON_UNSPECIFIED\x10\x00\x12\x15\n\x11SEARCH_ADD_ON_LLM\x10\x01\x42\xe9\n\n\'com.google.cloud.discoveryengine.v1betaB\x0b\x43ommonProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1beta\xea\x41\xe6\x01\n%discoveryengine.googleapis.com/Branch\x12Qprojects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}\x12jprojects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}\xea\x41m\n)discoveryengine.googleapis.com/Collection\x12@projects/{project}/locations/{location}/collections/{collection}\xea\x41R\n\'discoveryengine.googleapis.com/Location\x12\'projects/{project}/locations/{location}\xea\x41}\n.discoveryengine.googleapis.com/GroundingConfig\x12Kprojects/{project}/locations/{location}/groundingConfigs/{grounding_config}\xea\x41w\n,discoveryengine.googleapis.com/RankingConfig\x12Gprojects/{project}/locations/{location}/rankingConfigs/{ranking_config}\xea\x41y\n#healthcare.googleapis.com/FhirStore\x12Rprojects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}\xea\x41\xae\x02\n$discoveryengine.googleapis.com/Chunk\x12uprojects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}/chunks/{chunk}\x12\x8e\x01projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}/chunks/{chunk}b\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 
@@ -44,6 +44,7 @@ module Google
         DoubleList = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.DoubleList").msgclass
         IndustryVertical = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.IndustryVertical").enummodule
         SolutionType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.SolutionType").enummodule
+        SearchUseCase = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.SearchUseCase").enummodule
         SearchTier = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.SearchTier").enummodule
         SearchAddOn = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.SearchAddOn").enummodule
       end

data/lib/google/cloud/discoveryengine/v1beta/control_pb.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/discoveryengine/v1beta/control.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/discoveryengine/v1beta/common_pb'
+require 'google/protobuf/timestamp_pb'
+
+
+descriptor_data = "\n1google/cloud/discoveryengine/v1beta/control.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x30google/cloud/discoveryengine/v1beta/common.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xca\x02\n\tCondition\x12M\n\x0bquery_terms\x18\x02 \x03(\x0b\x32\x38.google.cloud.discoveryengine.v1beta.Condition.QueryTerm\x12S\n\x11\x61\x63tive_time_range\x18\x03 \x03(\x0b\x32\x38.google.cloud.discoveryengine.v1beta.Condition.TimeRange\x1a.\n\tQueryTerm\x12\r\n\x05value\x18\x01 \x01(\t\x12\x12\n\nfull_match\x18\x02 \x01(\x08\x1ai\n\tTimeRange\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb0\n\n\x07\x43ontrol\x12P\n\x0c\x62oost_action\x18\x06 \x01(\x0b\x32\x38.google.cloud.discoveryengine.v1beta.Control.BoostActionH\x00\x12R\n\rfilter_action\x18\x07 \x01(\x0b\x32\x39.google.cloud.discoveryengine.v1beta.Control.FilterActionH\x00\x12V\n\x0fredirect_action\x18\t \x01(\x0b\x32;.google.cloud.discoveryengine.v1beta.Control.RedirectActionH\x00\x12V\n\x0fsynonyms_action\x18\n \x01(\x0b\x32;.google.cloud.discoveryengine.v1beta.Control.SynonymsActionH\x00\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x05\x12\x19\n\x0c\x64isplay_name\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12*\n\x1d\x61ssociated_serving_config_ids\x18\x03 \x03(\tB\x03\xe0\x41\x03\x12P\n\rsolution_type\x18\x04 \x01(\x0e\x32\x31.google.cloud.discoveryengine.v1beta.SolutionTypeB\x06\xe0\x41\x02\xe0\x41\x05\x12\x45\n\tuse_cases\x18\x08 \x03(\x0e\x32\x32.google.cloud.discoveryengine.v1beta.SearchUseCase\x12\x42\n\nconditions\x18\x05 \x03(\x0b\x32..google.cloud.discoveryengine.v1beta.Condition\x1a|\n\x0b\x42oostAction\x12\x12\n\x05\x62oost\x18\x01 \x01(\x02\x42\x03\xe0\x41\x02\x12\x13\n\x06\x66ilter\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x44\n\ndata_store\x18\x03 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x1ai\n\x0c\x46ilterAction\x12\x13\n\x06\x66ilter\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x44\n\ndata_store\x18\x02 \x01(\tB0\xe0\x41\x02\xfa\x41*\n(discoveryengine.googleapis.com/DataStore\x1a+\n\x0eRedirectAction\x12\x19\n\x0credirect_uri\x18\x01 \x01(\tB\x03\xe0\x41\x02\x1a\"\n\x0eSynonymsAction\x12\x10\n\x08synonyms\x18\x01 \x03(\t:\xd3\x02\xea\x41\xcf\x02\n&discoveryengine.googleapis.com/Control\x12Rprojects/{project}/locations/{location}/dataStores/{data_store}/controls/{control}\x12kprojects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/controls/{control}\x12\x64projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/controls/{control}B\x08\n\x06\x61\x63tionB\x93\x02\n\'com.google.cloud.discoveryengine.v1betaB\x0c\x43ontrolProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1betab\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Cloud
+    module DiscoveryEngine
+      module V1beta
+        Condition = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.Condition").msgclass
+        Condition::QueryTerm = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.Condition.QueryTerm").msgclass
+        Condition::TimeRange = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.Condition.TimeRange").msgclass
+        Control = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.Control").msgclass
+        Control::BoostAction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.Control.BoostAction").msgclass
+        Control::FilterAction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.Control.FilterAction").msgclass
+        Control::RedirectAction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.Control.RedirectAction").msgclass
+        Control::SynonymsAction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.Control.SynonymsAction").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/discoveryengine/v1beta/control_service_pb.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/discoveryengine/v1beta/control_service.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/discoveryengine/v1beta/control_pb'
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/field_mask_pb'
+
+
+descriptor_data = "\n9google/cloud/discoveryengine/v1beta/control_service.proto\x12#google.cloud.discoveryengine.v1beta\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x31google/cloud/discoveryengine/v1beta/control.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\"\xb3\x01\n\x14\x43reateControlRequest\x12>\n\x06parent\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\x12&discoveryengine.googleapis.com/Control\x12\x42\n\x07\x63ontrol\x18\x02 \x01(\x0b\x32,.google.cloud.discoveryengine.v1beta.ControlB\x03\xe0\x41\x02\x12\x17\n\ncontrol_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\"\x90\x01\n\x14UpdateControlRequest\x12\x42\n\x07\x63ontrol\x18\x01 \x01(\x0b\x32,.google.cloud.discoveryengine.v1beta.ControlB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x01\"T\n\x14\x44\x65leteControlRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&discoveryengine.googleapis.com/Control\"Q\n\x11GetControlRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&discoveryengine.googleapis.com/Control\"\x9b\x01\n\x13ListControlsRequest\x12>\n\x06parent\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\x12&discoveryengine.googleapis.com/Control\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x13\n\x06\x66ilter\x18\x04 \x01(\tB\x03\xe0\x41\x01\"o\n\x14ListControlsResponse\x12>\n\x08\x63ontrols\x18\x01 \x03(\x0b\x32,.google.cloud.discoveryengine.v1beta.Control\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xc5\x0f\n\x0e\x43ontrolService\x12\x93\x03\n\rCreateControl\x12\x39.google.cloud.discoveryengine.v1beta.CreateControlRequest\x1a,.google.cloud.discoveryengine.v1beta.Control\"\x98\x02\xda\x41\x19parent,control,control_id\x82\xd3\xe4\x93\x02\xf5\x01\"=/v1beta/{parent=projects/*/locations/*/dataStores/*}/controls:\x07\x63ontrolZV\"K/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/controls:\x07\x63ontrolZS\"H/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/controls:\x07\x63ontrol\x12\xcd\x02\n\rDeleteControl\x12\x39.google.cloud.discoveryengine.v1beta.DeleteControlRequest\x1a\x16.google.protobuf.Empty\"\xe8\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xda\x01*=/v1beta/{name=projects/*/locations/*/dataStores/*/controls/*}ZM*K/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/controls/*}ZJ*H/v1beta/{name=projects/*/locations/*/collections/*/engines/*/controls/*}\x12\xa5\x03\n\rUpdateControl\x12\x39.google.cloud.discoveryengine.v1beta.UpdateControlRequest\x1a,.google.cloud.discoveryengine.v1beta.Control\"\xaa\x02\xda\x41\x13\x63ontrol,update_mask\x82\xd3\xe4\x93\x02\x8d\x02\x32\x45/v1beta/{control.name=projects/*/locations/*/dataStores/*/controls/*}:\x07\x63ontrolZ^2S/v1beta/{control.name=projects/*/locations/*/collections/*/dataStores/*/controls/*}:\x07\x63ontrolZ[2P/v1beta/{control.name=projects/*/locations/*/collections/*/engines/*/controls/*}:\x07\x63ontrol\x12\xdd\x02\n\nGetControl\x12\x36.google.cloud.discoveryengine.v1beta.GetControlRequest\x1a,.google.cloud.discoveryengine.v1beta.Control\"\xe8\x01\xda\x41\x04name\x82\xd3\xe4\x93\x02\xda\x01\x12=/v1beta/{name=projects/*/locations/*/dataStores/*/controls/*}ZM\x12K/v1beta/{name=projects/*/locations/*/collections/*/dataStores/*/controls/*}ZJ\x12H/v1beta/{name=projects/*/locations/*/collections/*/engines/*/controls/*}\x12\xf0\x02\n\x0cListControls\x12\x38.google.cloud.discoveryengine.v1beta.ListControlsRequest\x1a\x39.google.cloud.discoveryengine.v1beta.ListControlsResponse\"\xea\x01\xda\x41\x06parent\x82\xd3\xe4\x93\x02\xda\x01\x12=/v1beta/{parent=projects/*/locations/*/dataStores/*}/controlsZM\x12K/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/controlsZJ\x12H/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/controls\x1aR\xca\x41\x1e\x64iscoveryengine.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x9a\x02\n\'com.google.cloud.discoveryengine.v1betaB\x13\x43ontrolServiceProtoP\x01ZQcloud.google.com/go/discoveryengine/apiv1beta/discoveryenginepb;discoveryenginepb\xa2\x02\x0f\x44ISCOVERYENGINE\xaa\x02#Google.Cloud.DiscoveryEngine.V1Beta\xca\x02#Google\\Cloud\\DiscoveryEngine\\V1beta\xea\x02&Google::Cloud::DiscoveryEngine::V1betab\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.cloud.discoveryengine.v1beta.Control", "google/cloud/discoveryengine/v1beta/control.proto"],
+    ["google.protobuf.FieldMask", "google/protobuf/field_mask.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Cloud
+    module DiscoveryEngine
+      module V1beta
+        CreateControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.CreateControlRequest").msgclass
+        UpdateControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.UpdateControlRequest").msgclass
+        DeleteControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.DeleteControlRequest").msgclass
+        GetControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.GetControlRequest").msgclass
+        ListControlsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.ListControlsRequest").msgclass
+        ListControlsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.discoveryengine.v1beta.ListControlsResponse").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/discoveryengine/v1beta/control_service_services_pb.rb

@@ -0,0 +1,69 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/discoveryengine/v1beta/control_service.proto for package 'Google.Cloud.DiscoveryEngine.V1beta'
+# Original file comments:
+# 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.
+#
+
+require 'grpc'
+require 'google/cloud/discoveryengine/v1beta/control_service_pb'
+
+module Google
+  module Cloud
+    module DiscoveryEngine
+      module V1beta
+        module ControlService
+          # 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.
+          class Service
+
+            include ::GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.discoveryengine.v1beta.ControlService'
+
+            # 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, ::Google::Cloud::DiscoveryEngine::V1beta::CreateControlRequest, ::Google::Cloud::DiscoveryEngine::V1beta::Control
+            # Deletes a Control.
+            #
+            # If the [Control][google.cloud.discoveryengine.v1beta.Control] to delete
+            # does not exist, a NOT_FOUND error is returned.
+            rpc :DeleteControl, ::Google::Cloud::DiscoveryEngine::V1beta::DeleteControlRequest, ::Google::Protobuf::Empty
+            # 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, ::Google::Cloud::DiscoveryEngine::V1beta::UpdateControlRequest, ::Google::Cloud::DiscoveryEngine::V1beta::Control
+            # Gets a Control.
+            rpc :GetControl, ::Google::Cloud::DiscoveryEngine::V1beta::GetControlRequest, ::Google::Cloud::DiscoveryEngine::V1beta::Control
+            # Lists all Controls by their parent
+            # [DataStore][google.cloud.discoveryengine.v1beta.DataStore].
+            rpc :ListControls, ::Google::Cloud::DiscoveryEngine::V1beta::ListControlsRequest, ::Google::Cloud::DiscoveryEngine::V1beta::ListControlsResponse
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end