google-apis-discoveryengine_v1 0.4.0 → 0.5.0

data/lib/google/apis/discoveryengine_v1/classes.rb

@@ -510,6 +510,15 @@ module Google
         attr_accessor :ignore_adversarial_query
         alias_method :ignore_adversarial_query?, :ignore_adversarial_query
       
+        # Specifies whether to filter out queries that have low relevance. If this field
+        # is set to `false`, all search results are used regardless of relevance to
+        # generate answers. If set to `true` or unset, the behavior will be determined
+        # automatically by the service.
+        # Corresponds to the JSON property `ignoreLowRelevantContent`
+        # @return [Boolean]
+        attr_accessor :ignore_low_relevant_content
+        alias_method :ignore_low_relevant_content?, :ignore_low_relevant_content
+      
         # Specifies whether to filter out queries that are not answer-seeking. The
         # default value is `false`. Google employs search-query classification to detect
         # answer-seeking queries. No answer is returned if the search query is
@@ -546,6 +555,7 @@ module Google
         def update!(**args)
           @answer_language_code = args[:answer_language_code] if args.key?(:answer_language_code)
           @ignore_adversarial_query = args[:ignore_adversarial_query] if args.key?(:ignore_adversarial_query)
+          @ignore_low_relevant_content = args[:ignore_low_relevant_content] if args.key?(:ignore_low_relevant_content)
           @ignore_non_answer_seeking_query = args[:ignore_non_answer_seeking_query] if args.key?(:ignore_non_answer_seeking_query)
           @include_citations = args[:include_citations] if args.key?(:include_citations)
           @model_spec = args[:model_spec] if args.key?(:model_spec)
@@ -730,6 +740,14 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestBoostSpec]
         attr_accessor :boost_spec
       
+        # Specs defining dataStores to filter on in a search call and configurations for
+        # those dataStores. This is only considered for engines with multiple dataStores
+        # use case. For single dataStore within an engine, they should use the specs at
+        # the top level.
+        # Corresponds to the JSON property `dataStoreSpecs`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec>]
+        attr_accessor :data_store_specs
+      
         # The filter syntax consists of an expression language for constructing a
         # predicate from one or more fields of the documents being filtered. Filter
         # expression is case-sensitive. This will be used to filter search results which
@@ -767,6 +785,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @boost_spec = args[:boost_spec] if args.key?(:boost_spec)
+          @data_store_specs = args[:data_store_specs] if args.key?(:data_store_specs)
           @filter = args[:filter] if args.key?(:filter)
           @max_return_results = args[:max_return_results] if args.key?(:max_return_results)
           @order_by = args[:order_by] if args.key?(:order_by)
@@ -1120,6 +1139,12 @@ module Google
         # @return [String]
         attr_accessor :page_identifier
       
+        # The structured JSON metadata for the document. It is populated from the struct
+        # data from the Chunk in search result.
+        # Corresponds to the JSON property `structData`
+        # @return [Hash<String,Object>]
+        attr_accessor :struct_data
+      
         # Title.
         # Corresponds to the JSON property `title`
         # @return [String]
@@ -1138,6 +1163,7 @@ module Google
         def update!(**args)
           @document = args[:document] if args.key?(:document)
           @page_identifier = args[:page_identifier] if args.key?(:page_identifier)
+          @struct_data = args[:struct_data] if args.key?(:struct_data)
           @title = args[:title] if args.key?(:title)
           @uri = args[:uri] if args.key?(:uri)
         end
@@ -1157,6 +1183,12 @@ module Google
         # @return [String]
         attr_accessor :document
       
+        # The structured JSON metadata for the document. It is populated from the struct
+        # data from the Chunk in search result.
+        # Corresponds to the JSON property `structData`
+        # @return [Hash<String,Object>]
+        attr_accessor :struct_data
+      
         # Title.
         # Corresponds to the JSON property `title`
         # @return [String]
@@ -1175,6 +1207,7 @@ module Google
         def update!(**args)
           @chunk_contents = args[:chunk_contents] if args.key?(:chunk_contents)
           @document = args[:document] if args.key?(:document)
+          @struct_data = args[:struct_data] if args.key?(:struct_data)
           @title = args[:title] if args.key?(:title)
           @uri = args[:uri] if args.key?(:uri)
         end
@@ -2013,6 +2046,281 @@ module Google
         end
       end
       
+      # Defines circumstances to be checked before allowing a behavior
+      class GoogleCloudDiscoveryengineV1Condition
+        include Google::Apis::Core::Hashable
+      
+        # Range of time(s) specifying when condition is active. Maximum of 10 time
+        # ranges.
+        # Corresponds to the JSON property `activeTimeRange`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ConditionTimeRange>]
+        attr_accessor :active_time_range
+      
+        # Search only A list of terms to match the query on. Maximum of 10 query terms.
+        # Corresponds to the JSON property `queryTerms`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ConditionQueryTerm>]
+        attr_accessor :query_terms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @active_time_range = args[:active_time_range] if args.key?(:active_time_range)
+          @query_terms = args[:query_terms] if args.key?(:query_terms)
+        end
+      end
+      
+      # Matcher for search request query
+      class GoogleCloudDiscoveryengineV1ConditionQueryTerm
+        include Google::Apis::Core::Hashable
+      
+        # Whether the search query needs to exactly match the query term.
+        # Corresponds to the JSON property `fullMatch`
+        # @return [Boolean]
+        attr_accessor :full_match
+        alias_method :full_match?, :full_match
+      
+        # The specific query value to match against Must be lowercase, must be UTF-8.
+        # Can have at most 3 space separated terms if full_match is true. Cannot be an
+        # empty string. Maximum length of 5000 characters.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @full_match = args[:full_match] if args.key?(:full_match)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # Used for time-dependent conditions.
+      class GoogleCloudDiscoveryengineV1ConditionTimeRange
+        include Google::Apis::Core::Hashable
+      
+        # End of time range. Range is inclusive. Must be in the future.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Start of time range. Range is inclusive.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
+      # Defines a conditioned behavior to employ during serving. Must be attached to a
+      # ServingConfig to be considered at serving time. Permitted actions dependent on
+      # `SolutionType`.
+      class GoogleCloudDiscoveryengineV1Control
+        include Google::Apis::Core::Hashable
+      
+        # Output only. List of all ServingConfig ids this control is attached to. May
+        # take up to 10 minutes to update after changes.
+        # Corresponds to the JSON property `associatedServingConfigIds`
+        # @return [Array<String>]
+        attr_accessor :associated_serving_config_ids
+      
+        # Adjusts order of products in returned list.
+        # Corresponds to the JSON property `boostAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlBoostAction]
+        attr_accessor :boost_action
+      
+        # Determines when the associated action will trigger. Omit to always apply the
+        # action. Currently only a single condition may be specified. Otherwise an
+        # INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `conditions`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Condition>]
+        attr_accessor :conditions
+      
+        # Required. Human readable name. The identifier used in UI views. Must be UTF-8
+        # encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT
+        # error is thrown.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Specified which products may be included in results. Uses same filter as boost.
+        # Corresponds to the JSON property `filterAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlFilterAction]
+        attr_accessor :filter_action
+      
+        # Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/
+        # controls/*`
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Redirects a shopper to the provided URI.
+        # Corresponds to the JSON property `redirectAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlRedirectAction]
+        attr_accessor :redirect_action
+      
+        # Required. Immutable. What solution the control belongs to. Must be compatible
+        # with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `solutionType`
+        # @return [String]
+        attr_accessor :solution_type
+      
+        # Creates a set of terms that will act as synonyms of one another. Example: "
+        # happy" will also be considered as "glad", "glad" will also be considered as "
+        # happy".
+        # Corresponds to the JSON property `synonymsAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlSynonymsAction]
+        attr_accessor :synonyms_action
+      
+        # Specifies the use case for the control. Affects what condition fields can be
+        # set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case
+        # per control. Must be set when solution_type is SolutionType.
+        # SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `useCases`
+        # @return [Array<String>]
+        attr_accessor :use_cases
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @associated_serving_config_ids = args[:associated_serving_config_ids] if args.key?(:associated_serving_config_ids)
+          @boost_action = args[:boost_action] if args.key?(:boost_action)
+          @conditions = args[:conditions] if args.key?(:conditions)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @filter_action = args[:filter_action] if args.key?(:filter_action)
+          @name = args[:name] if args.key?(:name)
+          @redirect_action = args[:redirect_action] if args.key?(:redirect_action)
+          @solution_type = args[:solution_type] if args.key?(:solution_type)
+          @synonyms_action = args[:synonyms_action] if args.key?(:synonyms_action)
+          @use_cases = args[:use_cases] if args.key?(:use_cases)
+        end
+      end
+      
+      # Adjusts order of products in returned list.
+      class GoogleCloudDiscoveryengineV1ControlBoostAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. Strength of the boost, which should be in [-1, 1]. Negative boost
+        # means demotion. Default is 0.0 (No-op).
+        # Corresponds to the JSON property `boost`
+        # @return [Float]
+        attr_accessor :boost
+      
+        # Required. Specifies which data store's documents can be boosted by this
+        # control. Full data store name e.g. projects/123/locations/global/collections/
+        # default_collection/dataStores/default_data_store
+        # Corresponds to the JSON property `dataStore`
+        # @return [String]
+        attr_accessor :data_store
+      
+        # Required. Specifies which products to apply the boost to. If no filter is
+        # provided all products will be boosted (No-op). Syntax documentation: https://
+        # cloud.google.com/retail/docs/filter-and-order Maximum length is 5000
+        # characters. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @boost = args[:boost] if args.key?(:boost)
+          @data_store = args[:data_store] if args.key?(:data_store)
+          @filter = args[:filter] if args.key?(:filter)
+        end
+      end
+      
+      # Specified which products may be included in results. Uses same filter as boost.
+      class GoogleCloudDiscoveryengineV1ControlFilterAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. Specifies which data store's documents can be filtered by this
+        # control. Full data store name e.g. projects/123/locations/global/collections/
+        # default_collection/dataStores/default_data_store
+        # Corresponds to the JSON property `dataStore`
+        # @return [String]
+        attr_accessor :data_store
+      
+        # Required. A filter to apply on the matching condition results. Required Syntax
+        # documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum
+        # length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_store = args[:data_store] if args.key?(:data_store)
+          @filter = args[:filter] if args.key?(:filter)
+        end
+      end
+      
+      # Redirects a shopper to the provided URI.
+      class GoogleCloudDiscoveryengineV1ControlRedirectAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. The URI to which the shopper will be redirected. Required. URI must
+        # have length equal or less than 2000 characters. Otherwise an INVALID ARGUMENT
+        # error is thrown.
+        # Corresponds to the JSON property `redirectUri`
+        # @return [String]
+        attr_accessor :redirect_uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @redirect_uri = args[:redirect_uri] if args.key?(:redirect_uri)
+        end
+      end
+      
+      # Creates a set of terms that will act as synonyms of one another. Example: "
+      # happy" will also be considered as "glad", "glad" will also be considered as "
+      # happy".
+      class GoogleCloudDiscoveryengineV1ControlSynonymsAction
+        include Google::Apis::Core::Hashable
+      
+        # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at
+        # least 2 synonyms. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `synonyms`
+        # @return [Array<String>]
+        attr_accessor :synonyms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @synonyms = args[:synonyms] if args.key?(:synonyms)
+        end
+      end
+      
       # External conversation proto definition.
       class GoogleCloudDiscoveryengineV1Conversation
         include Google::Apis::Core::Hashable
@@ -3179,8 +3487,8 @@ module Google
       class GoogleCloudDiscoveryengineV1EngineCommonConfig
         include Google::Apis::Core::Hashable
       
-        # Immutable. The name of the company, business or entity that is associated with
-        # the engine. Setting this may help improve LLM related features.
+        # The name of the company, business or entity that is associated with the engine.
+        # Setting this may help improve LLM related features.
         # Corresponds to the JSON property `companyName`
         # @return [String]
         attr_accessor :company_name
@@ -3939,6 +4247,31 @@ module Google
         end
       end
       
+      # Response for ListControls method.
+      class GoogleCloudDiscoveryengineV1ListControlsResponse
+        include Google::Apis::Core::Hashable
+      
+        # All the Controls for a given data store.
+        # Corresponds to the JSON property `controls`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control>]
+        attr_accessor :controls
+      
+        # Pagination token, if not returned indicates the last page.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @controls = args[:controls] if args.key?(:controls)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Response for ListConversations method.
       class GoogleCloudDiscoveryengineV1ListConversationsResponse
         include Google::Apis::Core::Hashable
@@ -4249,36 +4582,32 @@ module Google
         end
       end
       
-      # Metadata related to the progress of the PurgeDocuments operation. This will be
-      # returned by the google.longrunning.Operation.metadata field.
-      class GoogleCloudDiscoveryengineV1PurgeDocumentsMetadata
+      # Metadata and configurations for a Google Cloud project in the service.
+      class GoogleCloudDiscoveryengineV1Project
         include Google::Apis::Core::Hashable
       
-        # Operation create time.
+        # Output only. The timestamp when this project is created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # Count of entries that encountered errors while processing.
-        # Corresponds to the JSON property `failureCount`
-        # @return [Fixnum]
-        attr_accessor :failure_count
-      
-        # Count of entries that were ignored as entries were not found.
-        # Corresponds to the JSON property `ignoredCount`
-        # @return [Fixnum]
-        attr_accessor :ignored_count
-      
-        # Count of entries that were deleted successfully.
-        # Corresponds to the JSON property `successCount`
-        # @return [Fixnum]
-        attr_accessor :success_count
+        # Output only. Full resource name of the project, for example `projects/`
+        # project_number``. Note that when making requests, project number and project
+        # id are both acceptable, but the server will always respond in project number.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
       
-        # Operation last update time. If the operation is done, this is also the finish
-        # time.
-        # Corresponds to the JSON property `updateTime`
+        # Output only. The timestamp when this project is successfully provisioned.
+        # Empty value means this project is still provisioning and is not ready for use.
+        # Corresponds to the JSON property `provisionCompletionTime`
         # @return [String]
-        attr_accessor :update_time
+        attr_accessor :provision_completion_time
+      
+        # Output only. A map of terms of services. The key is the `id` of ServiceTerms.
+        # Corresponds to the JSON property `serviceTermsMap`
+        # @return [Hash<String,Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ProjectServiceTerms>]
+        attr_accessor :service_terms_map
       
         def initialize(**args)
            update!(**args)
@@ -4287,26 +4616,162 @@ module Google
         # Update properties of this object
         def update!(**args)
           @create_time = args[:create_time] if args.key?(:create_time)
-          @failure_count = args[:failure_count] if args.key?(:failure_count)
-          @ignored_count = args[:ignored_count] if args.key?(:ignored_count)
-          @success_count = args[:success_count] if args.key?(:success_count)
-          @update_time = args[:update_time] if args.key?(:update_time)
+          @name = args[:name] if args.key?(:name)
+          @provision_completion_time = args[:provision_completion_time] if args.key?(:provision_completion_time)
+          @service_terms_map = args[:service_terms_map] if args.key?(:service_terms_map)
         end
       end
       
-      # Request message for DocumentService.PurgeDocuments method.
-      class GoogleCloudDiscoveryengineV1PurgeDocumentsRequest
+      # Metadata about the terms of service.
+      class GoogleCloudDiscoveryengineV1ProjectServiceTerms
         include Google::Apis::Core::Hashable
       
-        # Required. Filter matching documents to purge. Only currently supported value
-        # is `*` (all items).
-        # Corresponds to the JSON property `filter`
+        # The last time when the project agreed to the terms of service.
+        # Corresponds to the JSON property `acceptTime`
         # @return [String]
-        attr_accessor :filter
+        attr_accessor :accept_time
       
-        # Actually performs the purge. If `force` is set to false, return the expected
-        # purge count without deleting any documents.
-        # Corresponds to the JSON property `force`
+        # The last time when the project declined or revoked the agreement to terms of
+        # service.
+        # Corresponds to the JSON property `declineTime`
+        # @return [String]
+        attr_accessor :decline_time
+      
+        # The unique identifier of this terms of service. Available terms: * `
+        # GA_DATA_USE_TERMS`: [Terms for data use](https://cloud.google.com/retail/data-
+        # use-terms). When using this as `id`, the acceptable version to provide is `
+        # 2022-11-23`.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Whether the project has accepted/rejected the service terms or it is still
+        # pending.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # The version string of the terms of service. For acceptable values, see the
+        # comments for id above.
+        # Corresponds to the JSON property `version`
+        # @return [String]
+        attr_accessor :version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @accept_time = args[:accept_time] if args.key?(:accept_time)
+          @decline_time = args[:decline_time] if args.key?(:decline_time)
+          @id = args[:id] if args.key?(:id)
+          @state = args[:state] if args.key?(:state)
+          @version = args[:version] if args.key?(:version)
+        end
+      end
+      
+      # Metadata associated with a project provision operation.
+      class GoogleCloudDiscoveryengineV1ProvisionProjectMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request for ProjectService.ProvisionProject method.
+      class GoogleCloudDiscoveryengineV1ProvisionProjectRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. Set to `true` to specify that caller has read and would like to give
+        # consent to the [Terms for data use](https://cloud.google.com/retail/data-use-
+        # terms).
+        # Corresponds to the JSON property `acceptDataUseTerms`
+        # @return [Boolean]
+        attr_accessor :accept_data_use_terms
+        alias_method :accept_data_use_terms?, :accept_data_use_terms
+      
+        # Required. The version of the [Terms for data use](https://cloud.google.com/
+        # retail/data-use-terms) that caller has read and would like to give consent to.
+        # Acceptable version is `2022-11-23`, and this may change over time.
+        # Corresponds to the JSON property `dataUseTermsVersion`
+        # @return [String]
+        attr_accessor :data_use_terms_version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @accept_data_use_terms = args[:accept_data_use_terms] if args.key?(:accept_data_use_terms)
+          @data_use_terms_version = args[:data_use_terms_version] if args.key?(:data_use_terms_version)
+        end
+      end
+      
+      # Metadata related to the progress of the PurgeDocuments operation. This will be
+      # returned by the google.longrunning.Operation.metadata field.
+      class GoogleCloudDiscoveryengineV1PurgeDocumentsMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Operation create time.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Count of entries that encountered errors while processing.
+        # Corresponds to the JSON property `failureCount`
+        # @return [Fixnum]
+        attr_accessor :failure_count
+      
+        # Count of entries that were ignored as entries were not found.
+        # Corresponds to the JSON property `ignoredCount`
+        # @return [Fixnum]
+        attr_accessor :ignored_count
+      
+        # Count of entries that were deleted successfully.
+        # Corresponds to the JSON property `successCount`
+        # @return [Fixnum]
+        attr_accessor :success_count
+      
+        # Operation last update time. If the operation is done, this is also the finish
+        # time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @failure_count = args[:failure_count] if args.key?(:failure_count)
+          @ignored_count = args[:ignored_count] if args.key?(:ignored_count)
+          @success_count = args[:success_count] if args.key?(:success_count)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Request message for DocumentService.PurgeDocuments method.
+      class GoogleCloudDiscoveryengineV1PurgeDocumentsRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. Filter matching documents to purge. Only currently supported value
+        # is `*` (all items).
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        # Actually performs the purge. If `force` is set to false, return the expected
+        # purge count without deleting any documents.
+        # Corresponds to the JSON property `force`
         # @return [Boolean]
         attr_accessor :force
         alias_method :force?, :force
@@ -4475,6 +4940,21 @@ module Google
         # @return [Fixnum]
         attr_accessor :top_n
       
+        # 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.
+        # Corresponds to the JSON property `userLabels`
+        # @return [Hash<String,String>]
+        attr_accessor :user_labels
+      
         def initialize(**args)
            update!(**args)
         end
@@ -4486,6 +4966,7 @@ module Google
           @query = args[:query] if args.key?(:query)
           @records = args[:records] if args.key?(:records)
           @top_n = args[:top_n] if args.key?(:top_n)
+          @user_labels = args[:user_labels] if args.key?(:user_labels)
         end
       end
       
@@ -6536,6 +7017,15 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CompletionInfo]
         attr_accessor :completion_info
       
+        # The DataStore resource full name, of the form `projects/`project`/locations/`
+        # location`/collections/`collection_id`/dataStores/`data_store_id``. Optional.
+        # Only required for user events whose data store can't by determined by
+        # UserEvent.engine or UserEvent.documents. If data store is set in the parent of
+        # write/import/collect user event requests, this field can be omitted.
+        # Corresponds to the JSON property `dataStore`
+        # @return [String]
+        attr_accessor :data_store
+      
         # Should set to true if the request is made directly from the end user, in which
         # case the UserEvent.user_info.user_agent can be populated from the HTTP request.
         # This flag should be set only if the API request is made directly from the end
@@ -6558,6 +7048,14 @@ module Google
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1DocumentInfo>]
         attr_accessor :documents
       
+        # The Engine resource name, in the form of `projects/`project`/locations/`
+        # location`/collections/`collection_id`/engines/`engine_id``. Optional. Only
+        # required for Engine produced user events. For example, user events from
+        # blended search.
+        # Corresponds to the JSON property `engine`
+        # @return [String]
+        attr_accessor :engine
+      
         # Only required for UserEventService.ImportUserEvents method. Timestamp of when
         # the user event happened.
         # Corresponds to the JSON property `eventTime`
@@ -6665,8 +7163,10 @@ module Google
           @attributes = args[:attributes] if args.key?(:attributes)
           @attribution_token = args[:attribution_token] if args.key?(:attribution_token)
           @completion_info = args[:completion_info] if args.key?(:completion_info)
+          @data_store = args[:data_store] if args.key?(:data_store)
           @direct_user_request = args[:direct_user_request] if args.key?(:direct_user_request)
           @documents = args[:documents] if args.key?(:documents)
+          @engine = args[:engine] if args.key?(:engine)
           @event_time = args[:event_time] if args.key?(:event_time)
           @event_type = args[:event_type] if args.key?(:event_type)
           @filter = args[:filter] if args.key?(:filter)
@@ -6996,6 +7496,12 @@ module Google
         # @return [String]
         attr_accessor :page_identifier
       
+        # The structured JSON metadata for the document. It is populated from the struct
+        # data from the Chunk in search result.
+        # Corresponds to the JSON property `structData`
+        # @return [Hash<String,Object>]
+        attr_accessor :struct_data
+      
         # Title.
         # Corresponds to the JSON property `title`
         # @return [String]
@@ -7014,6 +7520,7 @@ module Google
         def update!(**args)
           @document = args[:document] if args.key?(:document)
           @page_identifier = args[:page_identifier] if args.key?(:page_identifier)
+          @struct_data = args[:struct_data] if args.key?(:struct_data)
           @title = args[:title] if args.key?(:title)
           @uri = args[:uri] if args.key?(:uri)
         end
@@ -7033,6 +7540,12 @@ module Google
         # @return [String]
         attr_accessor :document
       
+        # The structured JSON metadata for the document. It is populated from the struct
+        # data from the Chunk in search result.
+        # Corresponds to the JSON property `structData`
+        # @return [Hash<String,Object>]
+        attr_accessor :struct_data
+      
         # Title.
         # Corresponds to the JSON property `title`
         # @return [String]
@@ -7051,6 +7564,7 @@ module Google
         def update!(**args)
           @chunk_contents = args[:chunk_contents] if args.key?(:chunk_contents)
           @document = args[:document] if args.key?(:document)
+          @struct_data = args[:struct_data] if args.key?(:struct_data)
           @title = args[:title] if args.key?(:title)
           @uri = args[:uri] if args.key?(:uri)
         end
@@ -7329,22 +7843,20 @@ module Google
         end
       end
       
-      # Metadata related to the progress of the DataStoreService.CreateDataStore
-      # operation. This will be returned by the google.longrunning.Operation.metadata
-      # field.
-      class GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata
+      # Defines circumstances to be checked before allowing a behavior
+      class GoogleCloudDiscoveryengineV1alphaCondition
         include Google::Apis::Core::Hashable
       
-        # Operation create time.
-        # Corresponds to the JSON property `createTime`
-        # @return [String]
-        attr_accessor :create_time
+        # Range of time(s) specifying when condition is active. Maximum of 10 time
+        # ranges.
+        # Corresponds to the JSON property `activeTimeRange`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaConditionTimeRange>]
+        attr_accessor :active_time_range
       
-        # Operation last update time. If the operation is done, this is also the finish
-        # time.
-        # Corresponds to the JSON property `updateTime`
-        # @return [String]
-        attr_accessor :update_time
+        # Search only A list of terms to match the query on. Maximum of 10 query terms.
+        # Corresponds to the JSON property `queryTerms`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaConditionQueryTerm>]
+        attr_accessor :query_terms
       
         def initialize(**args)
            update!(**args)
@@ -7352,26 +7864,27 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @create_time = args[:create_time] if args.key?(:create_time)
-          @update_time = args[:update_time] if args.key?(:update_time)
+          @active_time_range = args[:active_time_range] if args.key?(:active_time_range)
+          @query_terms = args[:query_terms] if args.key?(:query_terms)
         end
       end
       
-      # Metadata related to the progress of the EngineService.CreateEngine operation.
-      # This will be returned by the google.longrunning.Operation.metadata field.
-      class GoogleCloudDiscoveryengineV1alphaCreateEngineMetadata
+      # Matcher for search request query
+      class GoogleCloudDiscoveryengineV1alphaConditionQueryTerm
         include Google::Apis::Core::Hashable
       
-        # Operation create time.
-        # Corresponds to the JSON property `createTime`
-        # @return [String]
-        attr_accessor :create_time
+        # Whether the search query needs to exactly match the query term.
+        # Corresponds to the JSON property `fullMatch`
+        # @return [Boolean]
+        attr_accessor :full_match
+        alias_method :full_match?, :full_match
       
-        # Operation last update time. If the operation is done, this is also the finish
-        # time.
-        # Corresponds to the JSON property `updateTime`
+        # The specific query value to match against Must be lowercase, must be UTF-8.
+        # Can have at most 3 space separated terms if full_match is true. Cannot be an
+        # empty string. Maximum length of 5000 characters.
+        # Corresponds to the JSON property `value`
         # @return [String]
-        attr_accessor :update_time
+        attr_accessor :value
       
         def initialize(**args)
            update!(**args)
@@ -7379,25 +7892,24 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @create_time = args[:create_time] if args.key?(:create_time)
-          @update_time = args[:update_time] if args.key?(:update_time)
+          @full_match = args[:full_match] if args.key?(:full_match)
+          @value = args[:value] if args.key?(:value)
         end
       end
       
-      # Metadata for Create Schema LRO.
-      class GoogleCloudDiscoveryengineV1alphaCreateSchemaMetadata
+      # Used for time-dependent conditions.
+      class GoogleCloudDiscoveryengineV1alphaConditionTimeRange
         include Google::Apis::Core::Hashable
       
-        # Operation create time.
-        # Corresponds to the JSON property `createTime`
+        # End of time range. Range is inclusive. Must be in the future.
+        # Corresponds to the JSON property `endTime`
         # @return [String]
-        attr_accessor :create_time
+        attr_accessor :end_time
       
-        # Operation last update time. If the operation is done, this is also the finish
-        # time.
-        # Corresponds to the JSON property `updateTime`
+        # Start of time range. Range is inclusive.
+        # Corresponds to the JSON property `startTime`
         # @return [String]
-        attr_accessor :update_time
+        attr_accessor :start_time
       
         def initialize(**args)
            update!(**args)
@@ -7405,27 +7917,78 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @create_time = args[:create_time] if args.key?(:create_time)
-          @update_time = args[:update_time] if args.key?(:update_time)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
         end
       end
       
-      # Metadata related to the progress of the SiteSearchEngineService.
-      # CreateTargetSite operation. This will be returned by the google.longrunning.
-      # Operation.metadata field.
-      class GoogleCloudDiscoveryengineV1alphaCreateTargetSiteMetadata
+      # Defines a conditioned behavior to employ during serving. Must be attached to a
+      # ServingConfig to be considered at serving time. Permitted actions dependent on
+      # `SolutionType`.
+      class GoogleCloudDiscoveryengineV1alphaControl
         include Google::Apis::Core::Hashable
       
-        # Operation create time.
-        # Corresponds to the JSON property `createTime`
+        # Output only. List of all ServingConfig ids this control is attached to. May
+        # take up to 10 minutes to update after changes.
+        # Corresponds to the JSON property `associatedServingConfigIds`
+        # @return [Array<String>]
+        attr_accessor :associated_serving_config_ids
+      
+        # Adjusts order of products in returned list.
+        # Corresponds to the JSON property `boostAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlBoostAction]
+        attr_accessor :boost_action
+      
+        # Determines when the associated action will trigger. Omit to always apply the
+        # action. Currently only a single condition may be specified. Otherwise an
+        # INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `conditions`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaCondition>]
+        attr_accessor :conditions
+      
+        # Required. Human readable name. The identifier used in UI views. Must be UTF-8
+        # encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT
+        # error is thrown.
+        # Corresponds to the JSON property `displayName`
         # @return [String]
-        attr_accessor :create_time
+        attr_accessor :display_name
       
-        # Operation last update time. If the operation is done, this is also the finish
-        # time.
-        # Corresponds to the JSON property `updateTime`
+        # Specified which products may be included in results. Uses same filter as boost.
+        # Corresponds to the JSON property `filterAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlFilterAction]
+        attr_accessor :filter_action
+      
+        # Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/
+        # controls/*`
+        # Corresponds to the JSON property `name`
         # @return [String]
-        attr_accessor :update_time
+        attr_accessor :name
+      
+        # Redirects a shopper to the provided URI.
+        # Corresponds to the JSON property `redirectAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlRedirectAction]
+        attr_accessor :redirect_action
+      
+        # Required. Immutable. What solution the control belongs to. Must be compatible
+        # with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `solutionType`
+        # @return [String]
+        attr_accessor :solution_type
+      
+        # Creates a set of terms that will act as synonyms of one another. Example: "
+        # happy" will also be considered as "glad", "glad" will also be considered as "
+        # happy".
+        # Corresponds to the JSON property `synonymsAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlSynonymsAction]
+        attr_accessor :synonyms_action
+      
+        # Specifies the use case for the control. Affects what condition fields can be
+        # set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case
+        # per control. Must be set when solution_type is SolutionType.
+        # SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `useCases`
+        # @return [Array<String>]
+        attr_accessor :use_cases
       
         def initialize(**args)
            update!(**args)
@@ -7433,31 +7996,257 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @create_time = args[:create_time] if args.key?(:create_time)
-          @update_time = args[:update_time] if args.key?(:update_time)
+          @associated_serving_config_ids = args[:associated_serving_config_ids] if args.key?(:associated_serving_config_ids)
+          @boost_action = args[:boost_action] if args.key?(:boost_action)
+          @conditions = args[:conditions] if args.key?(:conditions)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @filter_action = args[:filter_action] if args.key?(:filter_action)
+          @name = args[:name] if args.key?(:name)
+          @redirect_action = args[:redirect_action] if args.key?(:redirect_action)
+          @solution_type = args[:solution_type] if args.key?(:solution_type)
+          @synonyms_action = args[:synonyms_action] if args.key?(:synonyms_action)
+          @use_cases = args[:use_cases] if args.key?(:use_cases)
         end
       end
       
-      # Metadata that describes a custom tuned model.
-      class GoogleCloudDiscoveryengineV1alphaCustomTuningModel
+      # Adjusts order of products in returned list.
+      class GoogleCloudDiscoveryengineV1alphaControlBoostAction
         include Google::Apis::Core::Hashable
       
-        # Timestamp the Model was created at.
-        # Corresponds to the JSON property `createTime`
-        # @return [String]
-        attr_accessor :create_time
+        # Required. Strength of the boost, which should be in [-1, 1]. Negative boost
+        # means demotion. Default is 0.0 (No-op).
+        # Corresponds to the JSON property `boost`
+        # @return [Float]
+        attr_accessor :boost
       
-        # The display name of the model.
-        # Corresponds to the JSON property `displayName`
+        # Required. Specifies which data store's documents can be boosted by this
+        # control. Full data store name e.g. projects/123/locations/global/collections/
+        # default_collection/dataStores/default_data_store
+        # Corresponds to the JSON property `dataStore`
         # @return [String]
-        attr_accessor :display_name
+        attr_accessor :data_store
       
-        # The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`).
-        # Corresponds to the JSON property `modelState`
+        # Required. Specifies which products to apply the boost to. If no filter is
+        # provided all products will be boosted (No-op). Syntax documentation: https://
+        # cloud.google.com/retail/docs/filter-and-order Maximum length is 5000
+        # characters. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @boost = args[:boost] if args.key?(:boost)
+          @data_store = args[:data_store] if args.key?(:data_store)
+          @filter = args[:filter] if args.key?(:filter)
+        end
+      end
+      
+      # Specified which products may be included in results. Uses same filter as boost.
+      class GoogleCloudDiscoveryengineV1alphaControlFilterAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. Specifies which data store's documents can be filtered by this
+        # control. Full data store name e.g. projects/123/locations/global/collections/
+        # default_collection/dataStores/default_data_store
+        # Corresponds to the JSON property `dataStore`
+        # @return [String]
+        attr_accessor :data_store
+      
+        # Required. A filter to apply on the matching condition results. Required Syntax
+        # documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum
+        # length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_store = args[:data_store] if args.key?(:data_store)
+          @filter = args[:filter] if args.key?(:filter)
+        end
+      end
+      
+      # Redirects a shopper to the provided URI.
+      class GoogleCloudDiscoveryengineV1alphaControlRedirectAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. The URI to which the shopper will be redirected. Required. URI must
+        # have length equal or less than 2000 characters. Otherwise an INVALID ARGUMENT
+        # error is thrown.
+        # Corresponds to the JSON property `redirectUri`
+        # @return [String]
+        attr_accessor :redirect_uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @redirect_uri = args[:redirect_uri] if args.key?(:redirect_uri)
+        end
+      end
+      
+      # Creates a set of terms that will act as synonyms of one another. Example: "
+      # happy" will also be considered as "glad", "glad" will also be considered as "
+      # happy".
+      class GoogleCloudDiscoveryengineV1alphaControlSynonymsAction
+        include Google::Apis::Core::Hashable
+      
+        # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at
+        # least 2 synonyms. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `synonyms`
+        # @return [Array<String>]
+        attr_accessor :synonyms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @synonyms = args[:synonyms] if args.key?(:synonyms)
+        end
+      end
+      
+      # Metadata related to the progress of the DataStoreService.CreateDataStore
+      # operation. This will be returned by the google.longrunning.Operation.metadata
+      # field.
+      class GoogleCloudDiscoveryengineV1alphaCreateDataStoreMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Operation create time.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Operation last update time. If the operation is done, this is also the finish
+        # time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Metadata related to the progress of the EngineService.CreateEngine operation.
+      # This will be returned by the google.longrunning.Operation.metadata field.
+      class GoogleCloudDiscoveryengineV1alphaCreateEngineMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Operation create time.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Operation last update time. If the operation is done, this is also the finish
+        # time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Metadata for Create Schema LRO.
+      class GoogleCloudDiscoveryengineV1alphaCreateSchemaMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Operation create time.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Operation last update time. If the operation is done, this is also the finish
+        # time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Metadata related to the progress of the SiteSearchEngineService.
+      # CreateTargetSite operation. This will be returned by the google.longrunning.
+      # Operation.metadata field.
+      class GoogleCloudDiscoveryengineV1alphaCreateTargetSiteMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Operation create time.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Operation last update time. If the operation is done, this is also the finish
+        # time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Metadata that describes a custom tuned model.
+      class GoogleCloudDiscoveryengineV1alphaCustomTuningModel
+        include Google::Apis::Core::Hashable
+      
+        # Timestamp the Model was created at.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # The display name of the model.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`).
+        # Corresponds to the JSON property `modelState`
         # @return [String]
         attr_accessor :model_state
       
-        # 
+        # The version of the model.
         # Corresponds to the JSON property `modelVersion`
         # @return [Fixnum]
         attr_accessor :model_version
@@ -8170,8 +8959,8 @@ module Google
       class GoogleCloudDiscoveryengineV1alphaEngineCommonConfig
         include Google::Apis::Core::Hashable
       
-        # Immutable. The name of the company, business or entity that is associated with
-        # the engine. Setting this may help improve LLM related features.
+        # The name of the company, business or entity that is associated with the engine.
+        # Setting this may help improve LLM related features.
         # Corresponds to the JSON property `companyName`
         # @return [String]
         attr_accessor :company_name
@@ -8489,6 +9278,17 @@ module Google
         # @return [String]
         attr_accessor :retrievable_option
       
+        # Field paths for indexing custom attribute from schema.org data. More details
+        # of schema.org and its defined types can be found at [schema.org](https://
+        # schema.org). It is only used on advanced site search schema. Currently only
+        # support full path from root. The full path to a field is constructed by
+        # concatenating field names, starting from `_root`, with a period `.` as the
+        # delimiter. Examples: * Publish date of the root: _root.datePublished * Publish
+        # date of the reviews: _root.review.datePublished
+        # Corresponds to the JSON property `schemaOrgPaths`
+        # @return [Array<String>]
+        attr_accessor :schema_org_paths
+      
         # If searchable_option is SEARCHABLE_ENABLED, field values are searchable by
         # text queries in SearchService.Search. If SEARCHABLE_ENABLED but field type is
         # numerical, field values will not be searchable by text queries in
@@ -8518,6 +9318,7 @@ module Google
           @key_property_type = args[:key_property_type] if args.key?(:key_property_type)
           @recs_filterable_option = args[:recs_filterable_option] if args.key?(:recs_filterable_option)
           @retrievable_option = args[:retrievable_option] if args.key?(:retrievable_option)
+          @schema_org_paths = args[:schema_org_paths] if args.key?(:schema_org_paths)
           @searchable_option = args[:searchable_option] if args.key?(:searchable_option)
         end
       end
@@ -9740,6 +10541,281 @@ module Google
         end
       end
       
+      # Defines circumstances to be checked before allowing a behavior
+      class GoogleCloudDiscoveryengineV1betaCondition
+        include Google::Apis::Core::Hashable
+      
+        # Range of time(s) specifying when condition is active. Maximum of 10 time
+        # ranges.
+        # Corresponds to the JSON property `activeTimeRange`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaConditionTimeRange>]
+        attr_accessor :active_time_range
+      
+        # Search only A list of terms to match the query on. Maximum of 10 query terms.
+        # Corresponds to the JSON property `queryTerms`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaConditionQueryTerm>]
+        attr_accessor :query_terms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @active_time_range = args[:active_time_range] if args.key?(:active_time_range)
+          @query_terms = args[:query_terms] if args.key?(:query_terms)
+        end
+      end
+      
+      # Matcher for search request query
+      class GoogleCloudDiscoveryengineV1betaConditionQueryTerm
+        include Google::Apis::Core::Hashable
+      
+        # Whether the search query needs to exactly match the query term.
+        # Corresponds to the JSON property `fullMatch`
+        # @return [Boolean]
+        attr_accessor :full_match
+        alias_method :full_match?, :full_match
+      
+        # The specific query value to match against Must be lowercase, must be UTF-8.
+        # Can have at most 3 space separated terms if full_match is true. Cannot be an
+        # empty string. Maximum length of 5000 characters.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @full_match = args[:full_match] if args.key?(:full_match)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # Used for time-dependent conditions.
+      class GoogleCloudDiscoveryengineV1betaConditionTimeRange
+        include Google::Apis::Core::Hashable
+      
+        # End of time range. Range is inclusive. Must be in the future.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Start of time range. Range is inclusive.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
+      # Defines a conditioned behavior to employ during serving. Must be attached to a
+      # ServingConfig to be considered at serving time. Permitted actions dependent on
+      # `SolutionType`.
+      class GoogleCloudDiscoveryengineV1betaControl
+        include Google::Apis::Core::Hashable
+      
+        # Output only. List of all ServingConfig ids this control is attached to. May
+        # take up to 10 minutes to update after changes.
+        # Corresponds to the JSON property `associatedServingConfigIds`
+        # @return [Array<String>]
+        attr_accessor :associated_serving_config_ids
+      
+        # Adjusts order of products in returned list.
+        # Corresponds to the JSON property `boostAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlBoostAction]
+        attr_accessor :boost_action
+      
+        # Determines when the associated action will trigger. Omit to always apply the
+        # action. Currently only a single condition may be specified. Otherwise an
+        # INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `conditions`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaCondition>]
+        attr_accessor :conditions
+      
+        # Required. Human readable name. The identifier used in UI views. Must be UTF-8
+        # encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT
+        # error is thrown.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Specified which products may be included in results. Uses same filter as boost.
+        # Corresponds to the JSON property `filterAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlFilterAction]
+        attr_accessor :filter_action
+      
+        # Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/
+        # controls/*`
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Redirects a shopper to the provided URI.
+        # Corresponds to the JSON property `redirectAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlRedirectAction]
+        attr_accessor :redirect_action
+      
+        # Required. Immutable. What solution the control belongs to. Must be compatible
+        # with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `solutionType`
+        # @return [String]
+        attr_accessor :solution_type
+      
+        # Creates a set of terms that will act as synonyms of one another. Example: "
+        # happy" will also be considered as "glad", "glad" will also be considered as "
+        # happy".
+        # Corresponds to the JSON property `synonymsAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlSynonymsAction]
+        attr_accessor :synonyms_action
+      
+        # Specifies the use case for the control. Affects what condition fields can be
+        # set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case
+        # per control. Must be set when solution_type is SolutionType.
+        # SOLUTION_TYPE_SEARCH.
+        # Corresponds to the JSON property `useCases`
+        # @return [Array<String>]
+        attr_accessor :use_cases
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @associated_serving_config_ids = args[:associated_serving_config_ids] if args.key?(:associated_serving_config_ids)
+          @boost_action = args[:boost_action] if args.key?(:boost_action)
+          @conditions = args[:conditions] if args.key?(:conditions)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @filter_action = args[:filter_action] if args.key?(:filter_action)
+          @name = args[:name] if args.key?(:name)
+          @redirect_action = args[:redirect_action] if args.key?(:redirect_action)
+          @solution_type = args[:solution_type] if args.key?(:solution_type)
+          @synonyms_action = args[:synonyms_action] if args.key?(:synonyms_action)
+          @use_cases = args[:use_cases] if args.key?(:use_cases)
+        end
+      end
+      
+      # Adjusts order of products in returned list.
+      class GoogleCloudDiscoveryengineV1betaControlBoostAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. Strength of the boost, which should be in [-1, 1]. Negative boost
+        # means demotion. Default is 0.0 (No-op).
+        # Corresponds to the JSON property `boost`
+        # @return [Float]
+        attr_accessor :boost
+      
+        # Required. Specifies which data store's documents can be boosted by this
+        # control. Full data store name e.g. projects/123/locations/global/collections/
+        # default_collection/dataStores/default_data_store
+        # Corresponds to the JSON property `dataStore`
+        # @return [String]
+        attr_accessor :data_store
+      
+        # Required. Specifies which products to apply the boost to. If no filter is
+        # provided all products will be boosted (No-op). Syntax documentation: https://
+        # cloud.google.com/retail/docs/filter-and-order Maximum length is 5000
+        # characters. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @boost = args[:boost] if args.key?(:boost)
+          @data_store = args[:data_store] if args.key?(:data_store)
+          @filter = args[:filter] if args.key?(:filter)
+        end
+      end
+      
+      # Specified which products may be included in results. Uses same filter as boost.
+      class GoogleCloudDiscoveryengineV1betaControlFilterAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. Specifies which data store's documents can be filtered by this
+        # control. Full data store name e.g. projects/123/locations/global/collections/
+        # default_collection/dataStores/default_data_store
+        # Corresponds to the JSON property `dataStore`
+        # @return [String]
+        attr_accessor :data_store
+      
+        # Required. A filter to apply on the matching condition results. Required Syntax
+        # documentation: https://cloud.google.com/retail/docs/filter-and-order Maximum
+        # length is 5000 characters. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_store = args[:data_store] if args.key?(:data_store)
+          @filter = args[:filter] if args.key?(:filter)
+        end
+      end
+      
+      # Redirects a shopper to the provided URI.
+      class GoogleCloudDiscoveryengineV1betaControlRedirectAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. The URI to which the shopper will be redirected. Required. URI must
+        # have length equal or less than 2000 characters. Otherwise an INVALID ARGUMENT
+        # error is thrown.
+        # Corresponds to the JSON property `redirectUri`
+        # @return [String]
+        attr_accessor :redirect_uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @redirect_uri = args[:redirect_uri] if args.key?(:redirect_uri)
+        end
+      end
+      
+      # Creates a set of terms that will act as synonyms of one another. Example: "
+      # happy" will also be considered as "glad", "glad" will also be considered as "
+      # happy".
+      class GoogleCloudDiscoveryengineV1betaControlSynonymsAction
+        include Google::Apis::Core::Hashable
+      
+        # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at
+        # least 2 synonyms. Otherwise an INVALID ARGUMENT error is thrown.
+        # Corresponds to the JSON property `synonyms`
+        # @return [Array<String>]
+        attr_accessor :synonyms
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @synonyms = args[:synonyms] if args.key?(:synonyms)
+        end
+      end
+      
       # Metadata related to the progress of the DataStoreService.CreateDataStore
       # operation. This will be returned by the google.longrunning.Operation.metadata
       # field.
@@ -9868,7 +10944,7 @@ module Google
         # @return [String]
         attr_accessor :model_state
       
-        # 
+        # The version of the model.
         # Corresponds to the JSON property `modelVersion`
         # @return [Fixnum]
         attr_accessor :model_version
@@ -10473,8 +11549,8 @@ module Google
       class GoogleCloudDiscoveryengineV1betaEngineCommonConfig
         include Google::Apis::Core::Hashable
       
-        # Immutable. The name of the company, business or entity that is associated with
-        # the engine. Setting this may help improve LLM related features.
+        # The name of the company, business or entity that is associated with the engine.
+        # Setting this may help improve LLM related features.
         # Corresponds to the JSON property `companyName`
         # @return [String]
         attr_accessor :company_name
@@ -10765,6 +11841,108 @@ module Google
         end
       end
       
+      # Metadata and configurations for a Google Cloud project in the service.
+      class GoogleCloudDiscoveryengineV1betaProject
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The timestamp when this project is created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Output only. Full resource name of the project, for example `projects/`
+        # project_number``. Note that when making requests, project number and project
+        # id are both acceptable, but the server will always respond in project number.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. The timestamp when this project is successfully provisioned.
+        # Empty value means this project is still provisioning and is not ready for use.
+        # Corresponds to the JSON property `provisionCompletionTime`
+        # @return [String]
+        attr_accessor :provision_completion_time
+      
+        # Output only. A map of terms of services. The key is the `id` of ServiceTerms.
+        # Corresponds to the JSON property `serviceTermsMap`
+        # @return [Hash<String,Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaProjectServiceTerms>]
+        attr_accessor :service_terms_map
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @name = args[:name] if args.key?(:name)
+          @provision_completion_time = args[:provision_completion_time] if args.key?(:provision_completion_time)
+          @service_terms_map = args[:service_terms_map] if args.key?(:service_terms_map)
+        end
+      end
+      
+      # Metadata about the terms of service.
+      class GoogleCloudDiscoveryengineV1betaProjectServiceTerms
+        include Google::Apis::Core::Hashable
+      
+        # The last time when the project agreed to the terms of service.
+        # Corresponds to the JSON property `acceptTime`
+        # @return [String]
+        attr_accessor :accept_time
+      
+        # The last time when the project declined or revoked the agreement to terms of
+        # service.
+        # Corresponds to the JSON property `declineTime`
+        # @return [String]
+        attr_accessor :decline_time
+      
+        # The unique identifier of this terms of service. Available terms: * `
+        # GA_DATA_USE_TERMS`: [Terms for data use](https://cloud.google.com/retail/data-
+        # use-terms). When using this as `id`, the acceptable version to provide is `
+        # 2022-11-23`.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Whether the project has accepted/rejected the service terms or it is still
+        # pending.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # The version string of the terms of service. For acceptable values, see the
+        # comments for id above.
+        # Corresponds to the JSON property `version`
+        # @return [String]
+        attr_accessor :version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @accept_time = args[:accept_time] if args.key?(:accept_time)
+          @decline_time = args[:decline_time] if args.key?(:decline_time)
+          @id = args[:id] if args.key?(:id)
+          @state = args[:state] if args.key?(:state)
+          @version = args[:version] if args.key?(:version)
+        end
+      end
+      
+      # Metadata associated with a project provision operation.
+      class GoogleCloudDiscoveryengineV1betaProvisionProjectMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Metadata related to the progress of the PurgeDocuments operation. This will be
       # returned by the google.longrunning.Operation.metadata field.
       class GoogleCloudDiscoveryengineV1betaPurgeDocumentsMetadata