google-apis-discoveryengine_v1 0.21.0 → 0.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b909364916b63087fc7ab0616deca7fadfec0f4ee61bc9adc723cea416123ed4
-  data.tar.gz: 29ce96241bbe27475629015dd3c708fd4761ac7f2098d149ad3a2e321b812d75
+  metadata.gz: 30a1879dbe64d1967abdf3875b45fedb3e902f1f68a2743659d4e96c376baa17
+  data.tar.gz: 80afdab1f2072bd1928cd289fded63a03a2e23c5d7645f943ee55ae09b801f79
 SHA512:
-  metadata.gz: 5108d71126ff9d82873718bd200c4cdb73fc26c9556d393695b17b51f3b1812693f9b8d1548a09135ebf48118a38d85ef2ab8fca1480acd8143fe8735d27938e
-  data.tar.gz: d183d2f7dc8f48503be71a38e6773e6cc629129e0b858f2ed37d5ff7bd8b257d6ea9ff9af52fc5539541381fc5b32f81e53f5aacdb7c2d4f351190be308c9f88
+  metadata.gz: 71f4093f384d44f24bdf47f3997dace113b5a07adb95db9827da8bc678c48e85b8ca4e9ef83b2f365a10fcbfe5c39112009701c70b92d586a65d573f94595aef
+  data.tar.gz: '0978eadffc5abb7b5ca8d832ad4a4aaee3d6578aab3a6e133bfac3a4ebc70d3e7f3ecdb5833370a1920a51e32330f25313b40706228ccb4b43b42d2bbfb687a5'

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-discoveryengine_v1
 
+### v0.23.0 (2024-11-24)
+
+* Regenerated from discovery document revision 20241123
+
+### v0.22.0 (2024-11-17)
+
+* Regenerated from discovery document revision 20241110
+
 ### v0.21.0 (2024-11-03)
 
 * Regenerated from discovery document revision 20241030

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

@@ -1129,6 +1129,12 @@ module Google
       class GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec
         include Google::Apis::Core::Hashable
       
+        # Optional. Specifies whether to enable the filtering based on grounding score
+        # and at what level.
+        # Corresponds to the JSON property `filteringLevel`
+        # @return [String]
+        attr_accessor :filtering_level
+      
         # Optional. Specifies whether to include grounding_supports in the answer. The
         # default value is `false`. When this field is set to `true`, returned answer
         # will have `grounding_score` and will contain GroundingSupports for each claim.
@@ -1143,6 +1149,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @filtering_level = args[:filtering_level] if args.key?(:filtering_level)
           @include_grounding_supports = args[:include_grounding_supports] if args.key?(:include_grounding_supports)
         end
       end
@@ -2537,9 +2544,15 @@ module Google
         # List of facts cited across all claims in the answer candidate. These are
         # derived from the facts supplied in the request.
         # Corresponds to the JSON property `citedChunks`
-        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CheckGroundingResponseFactChunk>]
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1FactChunk>]
         attr_accessor :cited_chunks
       
+        # List of facts cited across all claims in the answer candidate. These are
+        # derived from the facts supplied in the request.
+        # Corresponds to the JSON property `citedFacts`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CheckGroundingResponseCheckGroundingFactChunk>]
+        attr_accessor :cited_facts
+      
         # Claim texts and citation info across all claims in the answer candidate.
         # Corresponds to the JSON property `claims`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim>]
@@ -2559,11 +2572,31 @@ module Google
         # Update properties of this object
         def update!(**args)
           @cited_chunks = args[:cited_chunks] if args.key?(:cited_chunks)
+          @cited_facts = args[:cited_facts] if args.key?(:cited_facts)
           @claims = args[:claims] if args.key?(:claims)
           @support_score = args[:support_score] if args.key?(:support_score)
         end
       end
       
+      # Fact chunk for grounding check.
+      class GoogleCloudDiscoveryengineV1CheckGroundingResponseCheckGroundingFactChunk
+        include Google::Apis::Core::Hashable
+      
+        # Text content of the fact chunk. Can be at most 10K characters long.
+        # Corresponds to the JSON property `chunkText`
+        # @return [String]
+        attr_accessor :chunk_text
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @chunk_text = args[:chunk_text] if args.key?(:chunk_text)
+        end
+      end
+      
       # Text and citation info for a claim in the answer candidate.
       class GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim
         include Google::Apis::Core::Hashable
@@ -2590,8 +2623,7 @@ module Google
         # 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, anti_citation_indices, and score should not be
-        # returned.
+        # therefore citation_indices should not be returned.
         # Corresponds to the JSON property `groundingCheckRequired`
         # @return [Boolean]
         attr_accessor :grounding_check_required
@@ -2617,33 +2649,6 @@ module Google
         end
       end
       
-      # Fact chunk for grounding check.
-      class GoogleCloudDiscoveryengineV1CheckGroundingResponseFactChunk
-        include Google::Apis::Core::Hashable
-      
-        # Text content of the fact chunk. Can be at most 10K characters long.
-        # Corresponds to the JSON property `chunkText`
-        # @return [String]
-        attr_accessor :chunk_text
-      
-        # Source from which this fact chunk was retrieved. For a fact chunk retrieved
-        # from inline facts, this field will contain the index of the specific fact from
-        # which this chunk was retrieved.
-        # Corresponds to the JSON property `source`
-        # @return [String]
-        attr_accessor :source
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @chunk_text = args[:chunk_text] if args.key?(:chunk_text)
-          @source = args[:source] if args.key?(:source)
-        end
-      end
-      
       # Specification for the grounding check.
       class GoogleCloudDiscoveryengineV1CheckGroundingSpec
         include Google::Apis::Core::Hashable
@@ -2715,7 +2720,7 @@ module Google
       
         # Output only. Represents the relevance score based on similarity. Higher score
         # indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only
-        # populated on SearchService.SearchResponse.
+        # populated on SearchResponse.
         # Corresponds to the JSON property `relevanceScore`
         # @return [Float]
         attr_accessor :relevance_score
@@ -3209,6 +3214,13 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # Promote certain links based on some trigger queries. Example: Promote shoe
+        # store link when searching for `shoe` keyword. The link can be outside of
+        # associated data store.
+        # Corresponds to the JSON property `promoteAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlPromoteAction]
+        attr_accessor :promote_action
+      
         # Redirects a shopper to the provided URI.
         # Corresponds to the JSON property `redirectAction`
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlRedirectAction]
@@ -3247,6 +3259,7 @@ module Google
           @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)
+          @promote_action = args[:promote_action] if args.key?(:promote_action)
           @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)
@@ -3320,6 +3333,34 @@ module Google
         end
       end
       
+      # Promote certain links based on some trigger queries. Example: Promote shoe
+      # store link when searching for `shoe` keyword. The link can be outside of
+      # associated data store.
+      class GoogleCloudDiscoveryengineV1ControlPromoteAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. Data store with which this promotion is attached to.
+        # Corresponds to the JSON property `dataStore`
+        # @return [String]
+        attr_accessor :data_store
+      
+        # Promotion proto includes uri and other helping information to display the
+        # promotion.
+        # Corresponds to the JSON property `searchLinkPromotion`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchLinkPromotion]
+        attr_accessor :search_link_promotion
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_store = args[:data_store] if args.key?(:data_store)
+          @search_link_promotion = args[:search_link_promotion] if args.key?(:search_link_promotion)
+        end
+      end
+      
       # Redirects a shopper to the provided URI.
       class GoogleCloudDiscoveryengineV1ControlRedirectAction
         include Google::Apis::Core::Hashable
@@ -4333,6 +4374,14 @@ module Google
       class GoogleCloudDiscoveryengineV1DocumentInfo
         include Google::Apis::Core::Hashable
       
+        # Optional. The conversion value associated with this Document. Must be set if
+        # UserEvent.event_type is "conversion". For example, a value of 1000 signifies
+        # that 1000 seconds were spent viewing a Document for the `watch` conversion
+        # type.
+        # Corresponds to the JSON property `conversionValue`
+        # @return [Float]
+        attr_accessor :conversion_value
+      
         # The Document resource ID.
         # Corresponds to the JSON property `id`
         # @return [String]
@@ -4376,6 +4425,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @conversion_value = args[:conversion_value] if args.key?(:conversion_value)
           @id = args[:id] if args.key?(:id)
           @joined = args[:joined] if args.key?(:joined)
           @name = args[:name] if args.key?(:name)
@@ -4868,6 +4918,45 @@ module Google
         end
       end
       
+      # Fact Chunk.
+      class GoogleCloudDiscoveryengineV1FactChunk
+        include Google::Apis::Core::Hashable
+      
+        # Text content of the fact chunk. Can be at most 10K characters long.
+        # Corresponds to the JSON property `chunkText`
+        # @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.
+        # Corresponds to the JSON property `source`
+        # @return [String]
+        attr_accessor :source
+      
+        # More fine-grained information for the source reference.
+        # Corresponds to the JSON property `sourceMetadata`
+        # @return [Hash<String,String>]
+        attr_accessor :source_metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # 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
+      end
+      
       # Response message for SiteSearchEngineService.FetchDomainVerificationStatus
       # method.
       class GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse
@@ -6007,6 +6096,11 @@ module Google
         # @return [String]
         attr_accessor :display_name
       
+        # Optional. The document IDs associated with this panel.
+        # Corresponds to the JSON property `documents`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1DocumentInfo>]
+        attr_accessor :documents
+      
         # Required. The panel ID.
         # Corresponds to the JSON property `panelId`
         # @return [String]
@@ -6031,6 +6125,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @display_name = args[:display_name] if args.key?(:display_name)
+          @documents = args[:documents] if args.key?(:documents)
           @panel_id = args[:panel_id] if args.key?(:panel_id)
           @panel_position = args[:panel_position] if args.key?(:panel_position)
           @total_panels = args[:total_panels] if args.key?(:total_panels)
@@ -6473,12 +6568,15 @@ module Google
         # : Double quoted UserEvent.event_type string. * `eventTime`: in ISO 8601 "zulu"
         # format. * `userPseudoId`: Double quoted string. Specifying this will delete
         # all events associated with a visitor. * `userId`: Double quoted string.
-        # Specifying this will delete all events associated with a user. Examples: *
-        # Deleting all events in a time range: `eventTime > "2012-04-23T18:25:43.511Z"
-        # eventTime < "2012-04-23T18:30:43.511Z"` * Deleting specific eventType: `
-        # eventType = "search"` * Deleting all events for a specific visitor: `
-        # userPseudoId = "visitor1024"` * Deleting all events inside a DataStore: `*`
-        # The filtering fields are assumed to have an implicit AND.
+        # Specifying this will delete all events associated with a user. Note: This API
+        # only supports purging a max range of 30 days. Examples: * Deleting all events
+        # in a time range: `eventTime > "2012-04-23T18:25:43.511Z" eventTime < "2012-04-
+        # 23T18:30:43.511Z"` * Deleting specific eventType in a time range: `eventTime >
+        # "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z" eventType = "
+        # search"` * Deleting all events for a specific visitor in a time range: `
+        # eventTime > "2012-04-23T18:25:43.511Z" eventTime < "2012-04-23T18:30:43.511Z"
+        # userPseudoId = "visitor1024"` * Deleting the past 30 days of events inside a
+        # DataStore: `*` The filtering fields are assumed to have an implicit AND.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -6627,7 +6725,9 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # The score of this record based on the given query and selected model.
+        # The score of this record based on the given query and selected model. The
+        # score will be rounded to 2 decimal places. If the score is close to 0, it will
+        # be rounded to 0.0001 to avoid returning unset.
         # Corresponds to the JSON property `score`
         # @return [Float]
         attr_accessor :score
@@ -6661,8 +6761,8 @@ module Google
         # ANY("Hot", "Cold"))` * `(filter_tags: ANY("Red", "Blue")) AND NOT (filter_tags:
         # ANY("Green"))` If `attributeFilteringSyntax` is set to true under the `params`
         # 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"))
+        # described tag-based syntax. Examples: * (language: ANY("en", "es")) AND NOT (
+        # categories: ANY("Movie")) * (available: true) AND (language: ANY("en", "es"))
         # 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
@@ -6947,6 +7047,53 @@ module Google
         end
       end
       
+      # Promotion proto includes uri and other helping information to display the
+      # promotion.
+      class GoogleCloudDiscoveryengineV1SearchLinkPromotion
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The Promotion description. Maximum length: 200 characters.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Optional. The enabled promotion will be returned for any serving configs
+        # associated with the parent of the control this promotion is attached to. This
+        # flag is used for basic site search only.
+        # Corresponds to the JSON property `enabled`
+        # @return [Boolean]
+        attr_accessor :enabled
+        alias_method :enabled?, :enabled
+      
+        # Optional. The promotion thumbnail image url.
+        # Corresponds to the JSON property `imageUri`
+        # @return [String]
+        attr_accessor :image_uri
+      
+        # Required. The title of the promotion. Maximum length: 160 characters.
+        # Corresponds to the JSON property `title`
+        # @return [String]
+        attr_accessor :title
+      
+        # Required. The URL for the page the user wants to promote.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @enabled = args[:enabled] if args.key?(:enabled)
+          @image_uri = args[:image_uri] if args.key?(:image_uri)
+          @title = args[:title] if args.key?(:title)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
       # Request message for SearchService.Search method.
       class GoogleCloudDiscoveryengineV1SearchRequest
         include Google::Apis::Core::Hashable
@@ -6981,10 +7128,10 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpec]
         attr_accessor :content_search_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.
+        # Specs defining DataStores to filter on in a search call and configurations for
+        # those data stores. This is only considered for Engines with multiple data
+        # stores. For engines with a single data store, the specs directly under
+        # SearchRequest should be used.
         # Corresponds to the JSON property `dataStoreSpecs`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec>]
         attr_accessor :data_store_specs
@@ -8043,6 +8190,11 @@ module Google
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchResponseSearchResult>]
         attr_accessor :results
       
+        # Promotions for site search.
+        # Corresponds to the JSON property `searchLinkPromotions`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchLinkPromotion>]
+        attr_accessor :search_link_promotions
+      
         # Information about the session.
         # Corresponds to the JSON property `sessionInfo`
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchResponseSessionInfo]
@@ -8073,6 +8225,7 @@ module Google
           @query_expansion_info = args[:query_expansion_info] if args.key?(:query_expansion_info)
           @redirect_uri = args[:redirect_uri] if args.key?(:redirect_uri)
           @results = args[:results] if args.key?(:results)
+          @search_link_promotions = args[:search_link_promotions] if args.key?(:search_link_promotions)
           @session_info = args[:session_info] if args.key?(:session_info)
           @summary = args[:summary] if args.key?(:summary)
           @total_size = args[:total_size] if args.key?(:total_size)
@@ -8523,6 +8676,11 @@ module Google
         # @return [String]
         attr_accessor :answer
       
+        # Defines an answer.
+        # Corresponds to the JSON property `detailedAnswer`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Answer]
+        attr_accessor :detailed_answer
+      
         # Defines a user inputed query.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Query]
@@ -8535,6 +8693,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @answer = args[:answer] if args.key?(:answer)
+          @detailed_answer = args[:detailed_answer] if args.key?(:detailed_answer)
           @query = args[:query] if args.key?(:query)
         end
       end
@@ -9161,6 +9320,15 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CompletionInfo]
         attr_accessor :completion_info
       
+        # Optional. Conversion type. Required if UserEvent.event_type is `conversion`.
+        # This is a customer-defined conversion name in lowercase letters or numbers
+        # separated by "-", such as "watch", "good-visit" etc. Do not set the field if
+        # UserEvent.event_type is not `conversion`. This mixes the custom conversion
+        # event with predefined events like `search`, `view-item` etc.
+        # Corresponds to the JSON property `conversionType`
+        # @return [String]
+        attr_accessor :conversion_type
+      
         # 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
@@ -9214,7 +9382,8 @@ module Google
         # values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online
         # shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`
         # : Start/resume watching a video, playing a song, etc. * `media-complete`:
-        # Finished or stopped midway through a video, song, etc.
+        # Finished or stopped midway through a video, song, etc. Custom conversion value:
+        # * `conversion`: Customer defined conversion event.
         # Corresponds to the JSON property `eventType`
         # @return [String]
         attr_accessor :event_type
@@ -9247,6 +9416,12 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1PanelInfo]
         attr_accessor :panel
       
+        # Optional. List of panels associated with this event. Used for page-level
+        # impression data.
+        # Corresponds to the JSON property `panels`
+        # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1PanelInfo>]
+        attr_accessor :panels
+      
         # The promotion IDs if this is an event associated with promotions. Currently,
         # this field is restricted to at most one ID.
         # Corresponds to the JSON property `promotionIds`
@@ -9308,6 +9483,7 @@ 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)
+          @conversion_type = args[:conversion_type] if args.key?(:conversion_type)
           @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)
@@ -9318,6 +9494,7 @@ module Google
           @media_info = args[:media_info] if args.key?(:media_info)
           @page_info = args[:page_info] if args.key?(:page_info)
           @panel = args[:panel] if args.key?(:panel)
+          @panels = args[:panels] if args.key?(:panels)
           @promotion_ids = args[:promotion_ids] if args.key?(:promotion_ids)
           @search_info = args[:search_info] if args.key?(:search_info)
           @session_id = args[:session_id] if args.key?(:session_id)
@@ -10292,6 +10469,13 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # Promote certain links based on some trigger queries. Example: Promote shoe
+        # store link when searching for `shoe` keyword. The link can be outside of
+        # associated data store.
+        # Corresponds to the JSON property `promoteAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlPromoteAction]
+        attr_accessor :promote_action
+      
         # Redirects a shopper to the provided URI.
         # Corresponds to the JSON property `redirectAction`
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlRedirectAction]
@@ -10330,6 +10514,7 @@ module Google
           @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)
+          @promote_action = args[:promote_action] if args.key?(:promote_action)
           @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)
@@ -10403,6 +10588,34 @@ module Google
         end
       end
       
+      # Promote certain links based on some trigger queries. Example: Promote shoe
+      # store link when searching for `shoe` keyword. The link can be outside of
+      # associated data store.
+      class GoogleCloudDiscoveryengineV1alphaControlPromoteAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. Data store with which this promotion is attached to.
+        # Corresponds to the JSON property `dataStore`
+        # @return [String]
+        attr_accessor :data_store
+      
+        # Promotion proto includes uri and other helping information to display the
+        # promotion.
+        # Corresponds to the JSON property `searchLinkPromotion`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion]
+        attr_accessor :search_link_promotion
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_store = args[:data_store] if args.key?(:data_store)
+          @search_link_promotion = args[:search_link_promotion] if args.key?(:search_link_promotion)
+        end
+      end
+      
       # Redirects a shopper to the provided URI.
       class GoogleCloudDiscoveryengineV1alphaControlRedirectAction
         include Google::Apis::Core::Hashable
@@ -13363,6 +13576,53 @@ module Google
         end
       end
       
+      # Promotion proto includes uri and other helping information to display the
+      # promotion.
+      class GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The Promotion description. Maximum length: 200 characters.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Optional. The enabled promotion will be returned for any serving configs
+        # associated with the parent of the control this promotion is attached to. This
+        # flag is used for basic site search only.
+        # Corresponds to the JSON property `enabled`
+        # @return [Boolean]
+        attr_accessor :enabled
+        alias_method :enabled?, :enabled
+      
+        # Optional. The promotion thumbnail image url.
+        # Corresponds to the JSON property `imageUri`
+        # @return [String]
+        attr_accessor :image_uri
+      
+        # Required. The title of the promotion. Maximum length: 160 characters.
+        # Corresponds to the JSON property `title`
+        # @return [String]
+        attr_accessor :title
+      
+        # Required. The URL for the page the user wants to promote.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @enabled = args[:enabled] if args.key?(:enabled)
+          @image_uri = args[:image_uri] if args.key?(:image_uri)
+          @title = args[:title] if args.key?(:title)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
       # Request message for SearchService.Search method.
       class GoogleCloudDiscoveryengineV1alphaSearchRequest
         include Google::Apis::Core::Hashable
@@ -13402,10 +13662,10 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaCustomFineTuningSpec]
         attr_accessor :custom_fine_tuning_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.
+        # Specs defining DataStores to filter on in a search call and configurations for
+        # those data stores. This is only considered for Engines with multiple data
+        # stores. For engines with a single data store, the specs directly under
+        # SearchRequest should be used.
         # Corresponds to the JSON property `dataStoreSpecs`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec>]
         attr_accessor :data_store_specs
@@ -14637,6 +14897,11 @@ module Google
         # @return [String]
         attr_accessor :answer
       
+        # Defines an answer.
+        # Corresponds to the JSON property `detailedAnswer`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswer]
+        attr_accessor :detailed_answer
+      
         # Defines a user inputed query.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaQuery]
@@ -14649,6 +14914,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @answer = args[:answer] if args.key?(:answer)
+          @detailed_answer = args[:detailed_answer] if args.key?(:detailed_answer)
           @query = args[:query] if args.key?(:query)
         end
       end
@@ -15385,6 +15651,13 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # Promote certain links based on some trigger queries. Example: Promote shoe
+        # store link when searching for `shoe` keyword. The link can be outside of
+        # associated data store.
+        # Corresponds to the JSON property `promoteAction`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlPromoteAction]
+        attr_accessor :promote_action
+      
         # Redirects a shopper to the provided URI.
         # Corresponds to the JSON property `redirectAction`
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlRedirectAction]
@@ -15423,6 +15696,7 @@ module Google
           @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)
+          @promote_action = args[:promote_action] if args.key?(:promote_action)
           @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)
@@ -15496,6 +15770,34 @@ module Google
         end
       end
       
+      # Promote certain links based on some trigger queries. Example: Promote shoe
+      # store link when searching for `shoe` keyword. The link can be outside of
+      # associated data store.
+      class GoogleCloudDiscoveryengineV1betaControlPromoteAction
+        include Google::Apis::Core::Hashable
+      
+        # Required. Data store with which this promotion is attached to.
+        # Corresponds to the JSON property `dataStore`
+        # @return [String]
+        attr_accessor :data_store
+      
+        # Promotion proto includes uri and other helping information to display the
+        # promotion.
+        # Corresponds to the JSON property `searchLinkPromotion`
+        # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchLinkPromotion]
+        attr_accessor :search_link_promotion
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_store = args[:data_store] if args.key?(:data_store)
+          @search_link_promotion = args[:search_link_promotion] if args.key?(:search_link_promotion)
+        end
+      end
+      
       # Redirects a shopper to the provided URI.
       class GoogleCloudDiscoveryengineV1betaControlRedirectAction
         include Google::Apis::Core::Hashable
@@ -17580,6 +17882,53 @@ module Google
         end
       end
       
+      # Promotion proto includes uri and other helping information to display the
+      # promotion.
+      class GoogleCloudDiscoveryengineV1betaSearchLinkPromotion
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The Promotion description. Maximum length: 200 characters.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Optional. The enabled promotion will be returned for any serving configs
+        # associated with the parent of the control this promotion is attached to. This
+        # flag is used for basic site search only.
+        # Corresponds to the JSON property `enabled`
+        # @return [Boolean]
+        attr_accessor :enabled
+        alias_method :enabled?, :enabled
+      
+        # Optional. The promotion thumbnail image url.
+        # Corresponds to the JSON property `imageUri`
+        # @return [String]
+        attr_accessor :image_uri
+      
+        # Required. The title of the promotion. Maximum length: 160 characters.
+        # Corresponds to the JSON property `title`
+        # @return [String]
+        attr_accessor :title
+      
+        # Required. The URL for the page the user wants to promote.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @enabled = args[:enabled] if args.key?(:enabled)
+          @image_uri = args[:image_uri] if args.key?(:image_uri)
+          @title = args[:title] if args.key?(:title)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
       # Request message for SearchService.Search method.
       class GoogleCloudDiscoveryengineV1betaSearchRequest
         include Google::Apis::Core::Hashable
@@ -17614,10 +17963,10 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpec]
         attr_accessor :content_search_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.
+        # Specs defining DataStores to filter on in a search call and configurations for
+        # those data stores. This is only considered for Engines with multiple data
+        # stores. For engines with a single data store, the specs directly under
+        # SearchRequest should be used.
         # Corresponds to the JSON property `dataStoreSpecs`
         # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec>]
         attr_accessor :data_store_specs

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DiscoveryengineV1
       # Version of the google-apis-discoveryengine_v1 gem
-      GEM_VERSION = "0.21.0"
+      GEM_VERSION = "0.23.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20241030"
+      REVISION = "20241123"
     end
   end
 end

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

@@ -454,13 +454,13 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim
+      class GoogleCloudDiscoveryengineV1CheckGroundingResponseCheckGroundingFactChunk
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class GoogleCloudDiscoveryengineV1CheckGroundingResponseFactChunk
+      class GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
@@ -568,6 +568,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDiscoveryengineV1ControlPromoteAction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDiscoveryengineV1ControlRedirectAction
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -832,6 +838,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDiscoveryengineV1FactChunk
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1204,6 +1216,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDiscoveryengineV1SearchLinkPromotion
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDiscoveryengineV1SearchRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1708,6 +1726,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDiscoveryengineV1alphaControlPromoteAction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDiscoveryengineV1alphaControlRedirectAction
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -2236,6 +2260,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDiscoveryengineV1alphaSearchRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -2548,6 +2578,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDiscoveryengineV1betaControlPromoteAction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDiscoveryengineV1betaControlRedirectAction
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -2932,6 +2968,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDiscoveryengineV1betaSearchLinkPromotion
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDiscoveryengineV1betaSearchRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -3489,6 +3531,7 @@ module Google
       class GoogleCloudDiscoveryengineV1AnswerQueryRequestGroundingSpec
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :filtering_level, as: 'filteringLevel'
           property :include_grounding_supports, as: 'includeGroundingSupports'
         end
       end
@@ -3914,7 +3957,9 @@ module Google
       class GoogleCloudDiscoveryengineV1CheckGroundingResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          collection :cited_chunks, as: 'citedChunks', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CheckGroundingResponseFactChunk, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CheckGroundingResponseFactChunk::Representation
+          collection :cited_chunks, as: 'citedChunks', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1FactChunk, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1FactChunk::Representation
+      
+          collection :cited_facts, as: 'citedFacts', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CheckGroundingResponseCheckGroundingFactChunk, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CheckGroundingResponseCheckGroundingFactChunk::Representation
       
           collection :claims, as: 'claims', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim::Representation
       
@@ -3922,6 +3967,13 @@ module Google
         end
       end
       
+      class GoogleCloudDiscoveryengineV1CheckGroundingResponseCheckGroundingFactChunk
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :chunk_text, as: 'chunkText'
+        end
+      end
+      
       class GoogleCloudDiscoveryengineV1CheckGroundingResponseClaim
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -3933,14 +3985,6 @@ module Google
         end
       end
       
-      class GoogleCloudDiscoveryengineV1CheckGroundingResponseFactChunk
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :chunk_text, as: 'chunkText'
-          property :source, as: 'source'
-        end
-      end
-      
       class GoogleCloudDiscoveryengineV1CheckGroundingSpec
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -4093,6 +4137,8 @@ module Google
           property :filter_action, as: 'filterAction', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlFilterAction, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlFilterAction::Representation
       
           property :name, as: 'name'
+          property :promote_action, as: 'promoteAction', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlPromoteAction, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlPromoteAction::Representation
+      
           property :redirect_action, as: 'redirectAction', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlRedirectAction, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ControlRedirectAction::Representation
       
           property :solution_type, as: 'solutionType'
@@ -4119,6 +4165,15 @@ module Google
         end
       end
       
+      class GoogleCloudDiscoveryengineV1ControlPromoteAction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :data_store, as: 'dataStore'
+          property :search_link_promotion, as: 'searchLinkPromotion', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchLinkPromotion, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchLinkPromotion::Representation
+      
+        end
+      end
+      
       class GoogleCloudDiscoveryengineV1ControlRedirectAction
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -4396,6 +4451,7 @@ module Google
       class GoogleCloudDiscoveryengineV1DocumentInfo
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :conversion_value, as: 'conversionValue'
           property :id, as: 'id'
           property :joined, as: 'joined'
           property :name, as: 'name'
@@ -4549,6 +4605,16 @@ module Google
         end
       end
       
+      class GoogleCloudDiscoveryengineV1FactChunk
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :chunk_text, as: 'chunkText'
+          property :index, as: 'index'
+          property :source, as: 'source'
+          hash :source_metadata, as: 'sourceMetadata'
+        end
+      end
+      
       class GoogleCloudDiscoveryengineV1FetchDomainVerificationStatusResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -4895,6 +4961,8 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :display_name, as: 'displayName'
+          collection :documents, as: 'documents', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1DocumentInfo, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1DocumentInfo::Representation
+      
           property :panel_id, as: 'panelId'
           property :panel_position, as: 'panelPosition'
           property :total_panels, as: 'totalPanels'
@@ -5145,6 +5213,17 @@ module Google
         end
       end
       
+      class GoogleCloudDiscoveryengineV1SearchLinkPromotion
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          property :enabled, as: 'enabled'
+          property :image_uri, as: 'imageUri'
+          property :title, as: 'title'
+          property :uri, as: 'uri'
+        end
+      end
+      
       class GoogleCloudDiscoveryengineV1SearchRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -5381,6 +5460,8 @@ module Google
           property :redirect_uri, as: 'redirectUri'
           collection :results, as: 'results', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchResponseSearchResult, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchResponseSearchResult::Representation
       
+          collection :search_link_promotions, as: 'searchLinkPromotions', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchLinkPromotion, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchLinkPromotion::Representation
+      
           property :session_info, as: 'sessionInfo', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchResponseSessionInfo, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchResponseSessionInfo::Representation
       
           property :summary, as: 'summary', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchResponseSummary, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchResponseSummary::Representation
@@ -5528,6 +5609,8 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :answer, as: 'answer'
+          property :detailed_answer, as: 'detailedAnswer', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Answer, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Answer::Representation
+      
           property :query, as: 'query', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Query, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Query::Representation
       
         end
@@ -5696,6 +5779,7 @@ module Google
           property :attribution_token, as: 'attributionToken'
           property :completion_info, as: 'completionInfo', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CompletionInfo, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CompletionInfo::Representation
       
+          property :conversion_type, as: 'conversionType'
           property :data_store, as: 'dataStore'
           property :direct_user_request, as: 'directUserRequest'
           collection :documents, as: 'documents', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1DocumentInfo, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1DocumentInfo::Representation
@@ -5710,6 +5794,8 @@ module Google
       
           property :panel, as: 'panel', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1PanelInfo, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1PanelInfo::Representation
       
+          collection :panels, as: 'panels', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1PanelInfo, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1PanelInfo::Representation
+      
           collection :promotion_ids, as: 'promotionIds'
           property :search_info, as: 'searchInfo', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchInfo, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchInfo::Representation
       
@@ -6009,6 +6095,8 @@ module Google
           property :filter_action, as: 'filterAction', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlFilterAction, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlFilterAction::Representation
       
           property :name, as: 'name'
+          property :promote_action, as: 'promoteAction', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlPromoteAction, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlPromoteAction::Representation
+      
           property :redirect_action, as: 'redirectAction', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlRedirectAction, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaControlRedirectAction::Representation
       
           property :solution_type, as: 'solutionType'
@@ -6035,6 +6123,15 @@ module Google
         end
       end
       
+      class GoogleCloudDiscoveryengineV1alphaControlPromoteAction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :data_store, as: 'dataStore'
+          property :search_link_promotion, as: 'searchLinkPromotion', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion::Representation
+      
+        end
+      end
+      
       class GoogleCloudDiscoveryengineV1alphaControlRedirectAction
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -6880,6 +6977,17 @@ module Google
         end
       end
       
+      class GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          property :enabled, as: 'enabled'
+          property :image_uri, as: 'imageUri'
+          property :title, as: 'title'
+          property :uri, as: 'uri'
+        end
+      end
+      
       class GoogleCloudDiscoveryengineV1alphaSearchRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -7163,6 +7271,8 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :answer, as: 'answer'
+          property :detailed_answer, as: 'detailedAnswer', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswer, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswer::Representation
+      
           property :query, as: 'query', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaQuery, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaQuery::Representation
       
         end
@@ -7381,6 +7491,8 @@ module Google
           property :filter_action, as: 'filterAction', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlFilterAction, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlFilterAction::Representation
       
           property :name, as: 'name'
+          property :promote_action, as: 'promoteAction', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlPromoteAction, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlPromoteAction::Representation
+      
           property :redirect_action, as: 'redirectAction', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlRedirectAction, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaControlRedirectAction::Representation
       
           property :solution_type, as: 'solutionType'
@@ -7407,6 +7519,15 @@ module Google
         end
       end
       
+      class GoogleCloudDiscoveryengineV1betaControlPromoteAction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :data_store, as: 'dataStore'
+          property :search_link_promotion, as: 'searchLinkPromotion', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchLinkPromotion, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchLinkPromotion::Representation
+      
+        end
+      end
+      
       class GoogleCloudDiscoveryengineV1betaControlRedirectAction
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -8018,6 +8139,17 @@ module Google
         end
       end
       
+      class GoogleCloudDiscoveryengineV1betaSearchLinkPromotion
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          property :enabled, as: 'enabled'
+          property :image_uri, as: 'imageUri'
+          property :title, as: 'title'
+          property :uri, as: 'uri'
+        end
+      end
+      
       class GoogleCloudDiscoveryengineV1betaSearchRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -836,8 +836,8 @@ module Google
         # Clients can use Operations.GetOperation or other methods to check whether the
         # cancellation succeeded or whether the operation completed despite cancellation.
         # On successful cancellation, the operation is not deleted; instead, it becomes
-        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
-        # corresponding to `Code.CANCELLED`.
+        # an operation with an Operation.error value with a google.rpc.Status.code of `1`
+        # , corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
         # @param [Google::Apis::DiscoveryengineV1::GoogleLongrunningCancelOperationRequest] google_longrunning_cancel_operation_request_object
@@ -4798,8 +4798,8 @@ module Google
         # Clients can use Operations.GetOperation or other methods to check whether the
         # cancellation succeeded or whether the operation completed despite cancellation.
         # On successful cancellation, the operation is not deleted; instead, it becomes
-        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
-        # corresponding to `Code.CANCELLED`.
+        # an operation with an Operation.error value with a google.rpc.Status.code of `1`
+        # , corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
         # @param [Google::Apis::DiscoveryengineV1::GoogleLongrunningCancelOperationRequest] google_longrunning_cancel_operation_request_object
@@ -6919,6 +6919,44 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Bulk import of user events. Request processing might be synchronous. Events
+        # that already exist are skipped. Use this method for backfilling historical
+        # user events. Operation.response is of type ImportResponse. Note that it is
+        # possible for a subset of the items to be successfully inserted. Operation.
+        # metadata is of type ImportMetadata.
+        # @param [String] parent
+        #   Required. Parent DataStore resource name, of the form `projects/`project`/
+        #   locations/`location`/collections/`collection`/dataStores/`data_store``
+        # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ImportUserEventsRequest] google_cloud_discoveryengine_v1_import_user_events_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def import_project_location_user_event(parent, google_cloud_discoveryengine_v1_import_user_events_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/userEvents:import', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ImportUserEventsRequest::Representation
+          command.request_object = google_cloud_discoveryengine_v1_import_user_events_request_object
+          command.response_representation = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Writes a single user event.
         # @param [String] parent
         #   Required. The parent resource name. If the write user event action is applied
@@ -6967,8 +7005,8 @@ module Google
         # Clients can use Operations.GetOperation or other methods to check whether the
         # cancellation succeeded or whether the operation completed despite cancellation.
         # On successful cancellation, the operation is not deleted; instead, it becomes
-        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
-        # corresponding to `Code.CANCELLED`.
+        # an operation with an Operation.error value with a google.rpc.Status.code of `1`
+        # , corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
         # @param [Google::Apis::DiscoveryengineV1::GoogleLongrunningCancelOperationRequest] google_longrunning_cancel_operation_request_object

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-discoveryengine_v1
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.23.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-11-03 00:00:00.000000000 Z
+date: 2024-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1/v0.21.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1/v0.23.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.21
+rubygems_version: 3.5.22
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Discovery Engine API V1