google-apis-discoveryengine_v1beta 0.43.0 → 0.45.0

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

@@ -849,8 +849,7 @@ module Google
       
         # The industry vertical that the engine registers. The restriction of the Engine
         # industry vertical is based on DataStore: If unspecified, default to `GENERIC`.
-        # Vertical on Engine has to match vertical of the DataStore liniked to the
-        # engine.
+        # Vertical on Engine has to match vertical of the DataStore linked to the engine.
         # Corresponds to the JSON property `industryVertical`
         # @return [String]
         attr_accessor :industry_vertical
@@ -1507,6 +1506,11 @@ module Google
         # @return [String]
         attr_accessor :provided_uri_pattern
       
+        # Output only. Root domain of the provided_uri_pattern.
+        # Corresponds to the JSON property `rootDomainUri`
+        # @return [String]
+        attr_accessor :root_domain_uri
+      
         # Verification information for target sites in advanced site search.
         # Corresponds to the JSON property `siteVerificationInfo`
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1SiteVerificationInfo]
@@ -1535,6 +1539,7 @@ module Google
           @indexing_status = args[:indexing_status] if args.key?(:indexing_status)
           @name = args[:name] if args.key?(:name)
           @provided_uri_pattern = args[:provided_uri_pattern] if args.key?(:provided_uri_pattern)
+          @root_domain_uri = args[:root_domain_uri] if args.key?(:root_domain_uri)
           @site_verification_info = args[:site_verification_info] if args.key?(:site_verification_info)
           @type = args[:type] if args.key?(:type)
           @update_time = args[:update_time] if args.key?(:update_time)
@@ -2355,6 +2360,58 @@ module Google
         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
+      
+        # 
+        # Corresponds to the JSON property `modelVersion`
+        # @return [Fixnum]
+        attr_accessor :model_version
+      
+        # Required. The fully qualified resource name of the model. Format: `projects/`
+        # project_number`/locations/`location`/collections/`collection`/dataStores/`
+        # data_store`/customTuningModels/`custom_tuning_model`` model must be an alpha-
+        # numerical string with limit of 40 characters.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Timestamp the model training was initiated.
+        # Corresponds to the JSON property `trainingStartTime`
+        # @return [String]
+        attr_accessor :training_start_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)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @model_state = args[:model_state] if args.key?(:model_state)
+          @model_version = args[:model_version] if args.key?(:model_version)
+          @name = args[:name] if args.key?(:name)
+          @training_start_time = args[:training_start_time] if args.key?(:training_start_time)
+        end
+      end
+      
       # DataStore captures global settings and configs at the DataStore level.
       class GoogleCloudDiscoveryengineV1alphaDataStore
         include Google::Apis::Core::Hashable
@@ -2862,8 +2919,7 @@ module Google
       
         # The industry vertical that the engine registers. The restriction of the Engine
         # industry vertical is based on DataStore: If unspecified, default to `GENERIC`.
-        # Vertical on Engine has to match vertical of the DataStore liniked to the
-        # engine.
+        # Vertical on Engine has to match vertical of the DataStore linked to the engine.
         # Corresponds to the JSON property `industryVertical`
         # @return [String]
         attr_accessor :industry_vertical
@@ -3662,6 +3718,25 @@ module Google
         end
       end
       
+      # Response message for SearchTuningService.ListCustomModels method.
+      class GoogleCloudDiscoveryengineV1alphaListCustomModelsResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of custom tuning models.
+        # Corresponds to the JSON property `models`
+        # @return [Array<Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1alphaCustomTuningModel>]
+        attr_accessor :models
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @models = args[:models] if args.key?(:models)
+        end
+      end
+      
       # Metadata and configurations for a Google Cloud project in the service.
       class GoogleCloudDiscoveryengineV1alphaProject
         include Google::Apis::Core::Hashable
@@ -4206,7 +4281,8 @@ module Google
       class GoogleCloudDiscoveryengineV1alphaSessionTurn
         include Google::Apis::Core::Hashable
       
-        # The resource name of the answer to the user query.
+        # The resource name of the answer to the user query. Only set if the answer
+        # generation (/answer API call) happened in this turn.
         # Corresponds to the JSON property `answer`
         # @return [String]
         attr_accessor :answer
@@ -4296,6 +4372,11 @@ module Google
         # @return [String]
         attr_accessor :provided_uri_pattern
       
+        # Output only. Root domain of the provided_uri_pattern.
+        # Corresponds to the JSON property `rootDomainUri`
+        # @return [String]
+        attr_accessor :root_domain_uri
+      
         # Verification information for target sites in advanced site search.
         # Corresponds to the JSON property `siteVerificationInfo`
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1alphaSiteVerificationInfo]
@@ -4324,6 +4405,7 @@ module Google
           @indexing_status = args[:indexing_status] if args.key?(:indexing_status)
           @name = args[:name] if args.key?(:name)
           @provided_uri_pattern = args[:provided_uri_pattern] if args.key?(:provided_uri_pattern)
+          @root_domain_uri = args[:root_domain_uri] if args.key?(:root_domain_uri)
           @site_verification_info = args[:site_verification_info] if args.key?(:site_verification_info)
           @type = args[:type] if args.key?(:type)
           @update_time = args[:update_time] if args.key?(:update_time)
@@ -4416,6 +4498,11 @@ module Google
         # @return [Hash<String,Float>]
         attr_accessor :metrics
       
+        # Fully qualified name of the CustomTuningModel.
+        # Corresponds to the JSON property `modelName`
+        # @return [String]
+        attr_accessor :model_name
+      
         # The trained model status. Possible values are: * **bad-data**: The training
         # data quality is bad. * **no-improvement**: Tuning didn't improve performance.
         # Won't deploy. * **in-progress**: Model training job creation is in progress. *
@@ -4435,6 +4522,7 @@ module Google
           @error_config = args[:error_config] if args.key?(:error_config)
           @error_samples = args[:error_samples] if args.key?(:error_samples)
           @metrics = args[:metrics] if args.key?(:metrics)
+          @model_name = args[:model_name] if args.key?(:model_name)
           @model_status = args[:model_status] if args.key?(:model_status)
         end
       end
@@ -4704,7 +4792,7 @@ module Google
       
         # The session resource name. Not required. When session field is not set, the
         # API is in sessionless mode. We support auto session mode: users can use the
-        # wildcard symbol “-” as session id. A new id will be automatically generated
+        # wildcard symbol `-` as session ID. A new ID will be automatically generated
         # and assigned.
         # Corresponds to the JSON property `session`
         # @return [String]
@@ -5977,7 +6065,7 @@ module Google
       class GoogleCloudDiscoveryengineV1betaCheckGroundingRequest
         include Google::Apis::Core::Hashable
       
-        # Answer candidate to check.
+        # Answer candidate to check. Can have a maximum length of 1024 characters.
         # Corresponds to the JSON property `answerCandidate`
         # @return [String]
         attr_accessor :answer_candidate
@@ -5992,6 +6080,21 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaCheckGroundingSpec]
         attr_accessor :grounding_spec
       
+        # 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
@@ -6001,6 +6104,7 @@ module Google
           @answer_candidate = args[:answer_candidate] if args.key?(:answer_candidate)
           @facts = args[:facts] if args.key?(:facts)
           @grounding_spec = args[:grounding_spec] if args.key?(:grounding_spec)
+          @user_labels = args[:user_labels] if args.key?(:user_labels)
         end
       end
       
@@ -6061,6 +6165,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :end_pos
       
+        # Indicates that this claim required grounding check. When the system decided
+        # this claim doesn't require attribution/grounding check, this field will be set
+        # to false. In that case, no grounding check was done for the claim and
+        # therefore citation_indices, and anti_citation_indices should not be returned.
+        # Corresponds to the JSON property `groundingCheckRequired`
+        # @return [Boolean]
+        attr_accessor :grounding_check_required
+        alias_method :grounding_check_required?, :grounding_check_required
+      
         # Position indicating the start of the claim in the answer candidate, measured
         # in bytes.
         # Corresponds to the JSON property `startPos`
@@ -6076,6 +6189,7 @@ module Google
           @citation_indices = args[:citation_indices] if args.key?(:citation_indices)
           @claim_text = args[:claim_text] if args.key?(:claim_text)
           @end_pos = args[:end_pos] if args.key?(:end_pos)
+          @grounding_check_required = args[:grounding_check_required] if args.key?(:grounding_check_required)
           @start_pos = args[:start_pos] if args.key?(:start_pos)
         end
       end
@@ -6646,6 +6760,58 @@ module Google
         end
       end
       
+      # Metadata that describes a custom tuned model.
+      class GoogleCloudDiscoveryengineV1betaCustomTuningModel
+        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
+      
+        # 
+        # Corresponds to the JSON property `modelVersion`
+        # @return [Fixnum]
+        attr_accessor :model_version
+      
+        # Required. The fully qualified resource name of the model. Format: `projects/`
+        # project_number`/locations/`location`/collections/`collection`/dataStores/`
+        # data_store`/customTuningModels/`custom_tuning_model`` model must be an alpha-
+        # numerical string with limit of 40 characters.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Timestamp the model training was initiated.
+        # Corresponds to the JSON property `trainingStartTime`
+        # @return [String]
+        attr_accessor :training_start_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)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @model_state = args[:model_state] if args.key?(:model_state)
+          @model_version = args[:model_version] if args.key?(:model_version)
+          @name = args[:name] if args.key?(:name)
+          @training_start_time = args[:training_start_time] if args.key?(:training_start_time)
+        end
+      end
+      
       # DataStore captures global settings and configs at the DataStore level.
       class GoogleCloudDiscoveryengineV1betaDataStore
         include Google::Apis::Core::Hashable
@@ -7034,9 +7200,9 @@ module Google
         attr_accessor :promotion_ids
       
         # Quantity of the Document associated with the user event. Defaults to 1. For
-        # example, this field will be 2 if two quantities of the same Document are
-        # involved in a `add-to-cart` event. Required for events of the following event
-        # types: * `add-to-cart` * `purchase`
+        # example, this field is 2 if two quantities of the same Document are involved
+        # in a `add-to-cart` event. Required for events of the following event types: * `
+        # add-to-cart` * `purchase`
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
@@ -7300,8 +7466,7 @@ module Google
       
         # The industry vertical that the engine registers. The restriction of the Engine
         # industry vertical is based on DataStore: If unspecified, default to `GENERIC`.
-        # Vertical on Engine has to match vertical of the DataStore liniked to the
-        # engine.
+        # Vertical on Engine has to match vertical of the DataStore linked to the engine.
         # Corresponds to the JSON property `industryVertical`
         # @return [String]
         attr_accessor :industry_vertical
@@ -7508,6 +7673,11 @@ module Google
         # @return [String]
         attr_accessor :chunk_text
       
+        # The index of this chunk. Currently, only used for the streaming mode.
+        # Corresponds to the JSON property `index`
+        # @return [Fixnum]
+        attr_accessor :index
+      
         # Source from which this fact chunk was retrieved. If it was retrieved from the
         # GroundingFacts provided in the request then this field will contain the index
         # of the specific fact from which this chunk was retrieved.
@@ -7527,6 +7697,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @chunk_text = args[:chunk_text] if args.key?(:chunk_text)
+          @index = args[:index] if args.key?(:index)
           @source = args[:source] if args.key?(:source)
           @source_metadata = args[:source_metadata] if args.key?(:source_metadata)
         end
@@ -7599,8 +7770,8 @@ module Google
       class GoogleCloudDiscoveryengineV1betaFirestoreSource
         include Google::Apis::Core::Hashable
       
-        # Required. The Firestore collection to copy the data from with a length limit
-        # of 1,500 characters.
+        # Required. The Firestore collection (or entity) to copy the data from with a
+        # length limit of 1,500 characters.
         # Corresponds to the JSON property `collectionId`
         # @return [String]
         attr_accessor :collection_id
@@ -7653,17 +7824,17 @@ module Google
         # vertical. * `csv`: A CSV file with header conforming to the defined Schema of
         # the data store. Each entry after the header is imported as a Document. This
         # can only be used by the GENERIC Data Store vertical. Supported values for user
-        # even imports: * `user_event` (default): One JSON UserEvent per line.
+        # event imports: * `user_event` (default): One JSON UserEvent per line.
         # Corresponds to the JSON property `dataSchema`
         # @return [String]
         attr_accessor :data_schema
       
-        # Required. Cloud Storage URIs to input files. URI can be up to 2000 characters
-        # long. URIs can match the full object path (for example, `gs://bucket/directory/
-        # object.json`) or a pattern matching one or more files, such as `gs://bucket/
-        # directory/*.json`. A request can contain at most 100 files (or 100,000 files
-        # if `data_schema` is `content`). Each file can be up to 2 GB (or 100 MB if `
-        # data_schema` is `content`).
+        # Required. Cloud Storage URIs to input files. Each URI can be up to 2000
+        # characters long. URIs can match the full object path (for example, `gs://
+        # bucket/directory/object.json`) or a pattern matching one or more files, such
+        # as `gs://bucket/directory/*.json`. A request can contain at most 100 files (or
+        # 100,000 files if `data_schema` is `content`). Each file can be up to 2 GB (or
+        # 100 MB if `data_schema` is `content`).
         # Corresponds to the JSON property `inputUris`
         # @return [Array<String>]
         attr_accessor :input_uris
@@ -8235,6 +8406,25 @@ module Google
         end
       end
       
+      # Response message for SearchTuningService.ListCustomModels method.
+      class GoogleCloudDiscoveryengineV1betaListCustomModelsResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of custom tuning models.
+        # Corresponds to the JSON property `models`
+        # @return [Array<Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaCustomTuningModel>]
+        attr_accessor :models
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @models = args[:models] if args.key?(:models)
+        end
+      end
+      
       # Response message for DataStoreService.ListDataStores method.
       class GoogleCloudDiscoveryengineV1betaListDataStoresResponse
         include Google::Apis::Core::Hashable
@@ -8868,45 +9058,44 @@ module Google
         # field, then attribute-based expressions are expected instead of the above
         # described tag-based syntax. Examples: * (launguage: ANY("en", "es")) AND NOT (
         # categories: ANY("Movie")) * (available: true) AND (launguage: ANY("en", "es"))
-        # OR (categories: ANY("Movie")) If your filter blocks all results, the API will
-        # return generic (unfiltered) popular Documents. If you only want results
-        # strictly matching the filters, set `strictFiltering` to True in
+        # OR (categories: ANY("Movie")) If your filter blocks all results, the API
+        # returns generic (unfiltered) popular Documents. If you only want results
+        # strictly matching the filters, set `strictFiltering` to `true` in
         # RecommendRequest.params to receive empty results instead. Note that the API
-        # will never return Documents with `storageStatus` of `EXPIRED` or `DELETED`
+        # never returns Documents with `storageStatus` as `EXPIRED` or `DELETED`
         # regardless of filter choices.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
       
         # Maximum number of results to return. Set this property to the number of
-        # recommendation results needed. If zero, the service will choose a reasonable
-        # default. The maximum allowed value is 100. Values above 100 will be coerced to
-        # 100.
+        # recommendation results needed. If zero, the service chooses a reasonable
+        # default. The maximum allowed value is 100. Values above 100 are set to 100.
         # Corresponds to the JSON property `pageSize`
         # @return [Fixnum]
         attr_accessor :page_size
       
         # Additional domain specific parameters for the recommendations. Allowed values:
-        # * `returnDocument`: Boolean. If set to true, the associated Document object
-        # will be returned in RecommendResponse.RecommendationResult.document. * `
-        # returnScore`: Boolean. If set to true, the recommendation 'score'
-        # corresponding to each returned Document will be set in RecommendResponse.
-        # RecommendationResult.metadata. The given 'score' indicates the probability of
-        # a Document conversion given the user's context and history. * `strictFiltering`
-        # : Boolean. True by default. If set to false, the service will return generic (
-        # unfiltered) popular Documents instead of empty if your filter blocks all
-        # recommendation results. * `diversityLevel`: String. Default empty. If set to
-        # be non-empty, then it needs to be one of: * `no-diversity` * `low-diversity` *
-        # `medium-diversity` * `high-diversity` * `auto-diversity` This gives request-
-        # level control and adjusts recommendation results based on Document category. *
-        # `attributeFilteringSyntax`: Boolean. False by default. If set to true, the `
-        # filter` field is interpreted according to the new, attribute-based syntax.
+        # * `returnDocument`: Boolean. If set to `true`, the associated Document object
+        # is returned in RecommendResponse.RecommendationResult.document. * `returnScore`
+        # : Boolean. If set to true, the recommendation score corresponding to each
+        # returned Document is set in RecommendResponse.RecommendationResult.metadata.
+        # The given score indicates the probability of a Document conversion given the
+        # user's context and history. * `strictFiltering`: Boolean. True by default. If
+        # set to `false`, the service returns generic (unfiltered) popular Documents
+        # instead of empty if your filter blocks all recommendation results. * `
+        # diversityLevel`: String. Default empty. If set to be non-empty, then it needs
+        # to be one of: * `no-diversity` * `low-diversity` * `medium-diversity` * `high-
+        # diversity` * `auto-diversity` This gives request-level control and adjusts
+        # recommendation results based on Document category. * `attributeFilteringSyntax`
+        # : Boolean. False by default. If set to true, the `filter` field is interpreted
+        # according to the new, attribute-based syntax.
         # Corresponds to the JSON property `params`
         # @return [Hash<String,Object>]
         attr_accessor :params
       
         # UserEvent captures all metadata information Discovery Engine API needs to know
-        # about how end users interact with customers' website.
+        # about how end users interact with your website.
         # Corresponds to the JSON property `userEvent`
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent]
         attr_accessor :user_event
@@ -8926,10 +9115,9 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :user_labels
       
-        # Use validate only mode for this recommendation query. If set to true, a fake
-        # model will be used that returns arbitrary Document IDs. Note that the validate
-        # only mode should only be used for testing the API, or if the model is not
-        # ready.
+        # Use validate only mode for this recommendation query. If set to `true`, a fake
+        # model is used that returns arbitrary Document IDs. Note that the validate only
+        # mode should only be used for testing the API, or if the model is not ready.
         # Corresponds to the JSON property `validateOnly`
         # @return [Boolean]
         attr_accessor :validate_only
@@ -9008,7 +9196,7 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Additional Document metadata / annotations. Possible values: * `score`:
+        # Additional Document metadata or annotations. Possible values: * `score`:
         # Recommendation score in double value. Is set if `returnScore` is set to true
         # in RecommendRequest.params.
         # Corresponds to the JSON property `metadata`
@@ -9062,7 +9250,7 @@ module Google
         # @return [String]
         attr_accessor :reply
       
-        # Summary of the top N search result specified by the summary spec.
+        # Summary of the top N search results specified by the summary spec.
         # Corresponds to the JSON property `summary`
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseSummary]
         attr_accessor :summary
@@ -9242,7 +9430,10 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpec]
         attr_accessor :content_search_spec
       
-        # A list of data store specs to apply on a search call.
+        # 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::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec>]
         attr_accessor :data_store_specs
@@ -9290,9 +9481,9 @@ module Google
       
         # The order in which documents are returned. Documents can be ordered by a field
         # in an Document object. Leave it unset if ordered by relevance. `order_by`
-        # expression is case-sensitive. For more information on ordering, see [Ordering](
-        # https://cloud.google.com/retail/docs/filter-and-order#order) If this field is
-        # unrecognizable, an `INVALID_ARGUMENT` is returned.
+        # expression is case-sensitive. For more information on ordering for retail
+        # search, see [Ordering](https://cloud.google.com/retail/docs/filter-and-order#
+        # order) If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
         # Corresponds to the JSON property `orderBy`
         # @return [String]
         attr_accessor :order_by
@@ -9316,12 +9507,12 @@ module Google
       
         # Additional search parameters. For public website search only, supported values
         # are: * `user_country_code`: string. Default empty. If set to non-empty,
-        # results are restricted or boosted based on the location provided. Example:
-        # user_country_code: "au" For available codes see [Country Codes](https://
+        # results are restricted or boosted based on the location provided. For example,
+        # `user_country_code: "au"` For available codes see [Country Codes](https://
         # developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `
         # search_type`: double. Default empty. Enables non-webpage searching depending
         # on the value. The only valid non-default value is 1, which enables image
-        # searching. Example: search_type: 1
+        # searching. For example, `search_type: 1`
         # Corresponds to the JSON property `params`
         # @return [Hash<String,Object>]
         attr_accessor :params
@@ -9845,7 +10036,9 @@ module Google
         end
       end
       
-      # A struct to define data stores to filter on in a search call.
+      # A struct to define data stores to filter on in a search call and
+      # configurations for those data stores. A maximum of 1 DataStoreSpec per
+      # data_store is allowed. Otherwise, an `INVALID_ARGUMENT` error is returned.
       class GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec
         include Google::Apis::Core::Hashable
       
@@ -9961,9 +10154,9 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchRequestFacetSpecFacetKey]
         attr_accessor :facet_key
       
-        # Maximum of facet values that should be returned for this facet. If unspecified,
-        # defaults to 20. The maximum allowed value is 300. Values above 300 are
-        # coerced to 300. If this field is negative, an `INVALID_ARGUMENT` is returned.
+        # Maximum facet values that are returned for this facet. If unspecified,
+        # defaults to 20. The maximum allowed value is 300. Values above 300 are coerced
+        # to 300. If this field is negative, an `INVALID_ARGUMENT` is returned.
         # Corresponds to the JSON property `limit`
         # @return [Fixnum]
         attr_accessor :limit
@@ -9992,7 +10185,7 @@ module Google
         attr_accessor :case_insensitive
         alias_method :case_insensitive?, :case_insensitive
       
-        # Only get facet values that contains the given strings. For example, suppose "
+        # Only get facet values that contain the given strings. For example, suppose "
         # category" has three values "Action > 2022", "Action > 2021" and "Sci-Fi > 2022"
         # . If set "contains" to "2022", the "category" facet only contains "Action >
         # 2022" and "Sci-Fi > 2022". Only supported on textual fields. Maximum is 10.
@@ -10109,8 +10302,8 @@ module Google
       class GoogleCloudDiscoveryengineV1betaSearchRequestSpellCorrectionSpec
         include Google::Apis::Core::Hashable
       
-        # The mode under which spell correction should take effect to replace the
-        # original search query. Default to Mode.AUTO.
+        # The mode under which spell correction replaces the original search query.
+        # Defaults to Mode.AUTO.
         # Corresponds to the JSON property `mode`
         # @return [String]
         attr_accessor :mode
@@ -10188,7 +10381,7 @@ module Google
         # @return [Array<Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseSearchResult>]
         attr_accessor :results
       
-        # Summary of the top N search result specified by the summary spec.
+        # Summary of the top N search results specified by the summary spec.
         # Corresponds to the JSON property `summary`
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchResponseSummary]
         attr_accessor :summary
@@ -10231,8 +10424,8 @@ module Google
         attr_accessor :dynamic_facet
         alias_method :dynamic_facet?, :dynamic_facet
       
-        # The key for this facet. E.g., "colors" or "price". It matches SearchRequest.
-        # FacetSpec.FacetKey.key.
+        # The key for this facet. For example, `"colors"` or `"price"`. It matches
+        # SearchRequest.FacetSpec.FacetKey.key.
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
@@ -10341,12 +10534,12 @@ module Google
       class GoogleCloudDiscoveryengineV1betaSearchResponseGuidedSearchResultRefinementAttribute
         include Google::Apis::Core::Hashable
       
-        # Attribute key used to refine the results e.g. 'movie_type'.
+        # Attribute key used to refine the results. For example, `"movie_type"`.
         # Corresponds to the JSON property `attributeKey`
         # @return [String]
         attr_accessor :attribute_key
       
-        # Attribute value used to refine the results e.g. 'drama'.
+        # Attribute value used to refine the results. For example, `"drama"`.
         # Corresponds to the JSON property `attributeValue`
         # @return [String]
         attr_accessor :attribute_value
@@ -10422,7 +10615,7 @@ module Google
         end
       end
       
-      # Summary of the top N search result specified by the summary spec.
+      # Summary of the top N search results specified by the summary spec.
       class GoogleCloudDiscoveryengineV1betaSearchResponseSummary
         include Google::Apis::Core::Hashable
       
@@ -10962,7 +11155,8 @@ module Google
       class GoogleCloudDiscoveryengineV1betaSessionTurn
         include Google::Apis::Core::Hashable
       
-        # The resource name of the answer to the user query.
+        # The resource name of the answer to the user query. Only set if the answer
+        # generation (/answer API call) happened in this turn.
         # Corresponds to the JSON property `answer`
         # @return [String]
         attr_accessor :answer
@@ -11148,6 +11342,11 @@ module Google
         # @return [String]
         attr_accessor :provided_uri_pattern
       
+        # Output only. Root domain of the provided_uri_pattern.
+        # Corresponds to the JSON property `rootDomainUri`
+        # @return [String]
+        attr_accessor :root_domain_uri
+      
         # Verification information for target sites in advanced site search.
         # Corresponds to the JSON property `siteVerificationInfo`
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSiteVerificationInfo]
@@ -11176,6 +11375,7 @@ module Google
           @indexing_status = args[:indexing_status] if args.key?(:indexing_status)
           @name = args[:name] if args.key?(:name)
           @provided_uri_pattern = args[:provided_uri_pattern] if args.key?(:provided_uri_pattern)
+          @root_domain_uri = args[:root_domain_uri] if args.key?(:root_domain_uri)
           @site_verification_info = args[:site_verification_info] if args.key?(:site_verification_info)
           @type = args[:type] if args.key?(:type)
           @update_time = args[:update_time] if args.key?(:update_time)
@@ -11287,6 +11487,11 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaTrainCustomModelRequestGcsTrainingInput]
         attr_accessor :gcs_training_input
       
+        # If not provided, a UUID will be generated.
+        # Corresponds to the JSON property `modelId`
+        # @return [String]
+        attr_accessor :model_id
+      
         # Model to be trained. Supported values are: * **search-tuning**: Fine tuning
         # the search system based on data provided.
         # Corresponds to the JSON property `modelType`
@@ -11301,6 +11506,7 @@ module Google
         def update!(**args)
           @error_config = args[:error_config] if args.key?(:error_config)
           @gcs_training_input = args[:gcs_training_input] if args.key?(:gcs_training_input)
+          @model_id = args[:model_id] if args.key?(:model_id)
           @model_type = args[:model_type] if args.key?(:model_type)
         end
       end
@@ -11374,6 +11580,11 @@ module Google
         # @return [Hash<String,Float>]
         attr_accessor :metrics
       
+        # Fully qualified name of the CustomTuningModel.
+        # Corresponds to the JSON property `modelName`
+        # @return [String]
+        attr_accessor :model_name
+      
         # The trained model status. Possible values are: * **bad-data**: The training
         # data quality is bad. * **no-improvement**: Tuning didn't improve performance.
         # Won't deploy. * **in-progress**: Model training job creation is in progress. *
@@ -11393,6 +11604,7 @@ module Google
           @error_config = args[:error_config] if args.key?(:error_config)
           @error_samples = args[:error_samples] if args.key?(:error_samples)
           @metrics = args[:metrics] if args.key?(:metrics)
+          @model_name = args[:model_name] if args.key?(:model_name)
           @model_status = args[:model_status] if args.key?(:model_status)
         end
       end
@@ -11559,7 +11771,7 @@ module Google
       end
       
       # UserEvent captures all metadata information Discovery Engine API needs to know
-      # about how end users interact with customers' website.
+      # about how end users interact with your website.
       class GoogleCloudDiscoveryengineV1betaUserEvent
         include Google::Apis::Core::Hashable
       
@@ -11698,7 +11910,7 @@ module Google
       
         # A list of identifiers for the independent experiment groups this user event
         # belongs to. This is used to distinguish between user events associated with
-        # different experiment setups on the customer end.
+        # different experiment setups.
         # Corresponds to the JSON property `tagIds`
         # @return [Array<String>]
         attr_accessor :tag_ids
@@ -11788,6 +12000,19 @@ module Google
         end
       end
       
+      # The request message for Operations.CancelOperation.
+      class GoogleLongrunningCancelOperationRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # The response message for Operations.ListOperations.
       class GoogleLongrunningListOperationsResponse
         include Google::Apis::Core::Hashable