google-apis-retail_v2 0.100.0 → 0.102.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50806bd8c7a875ac516316f6a64c9f35171c02406fa26f1396241e1b644d886a
-  data.tar.gz: 0d789d23af963e470c21d523ae886456dc472254c60a1c9e924eb06d98e8862d
+  metadata.gz: 50d7c27a64e08e19a6f529f86ae53beb01553354756e8aef1a8805f6b0e3254a
+  data.tar.gz: 9601ce54bb68ca89eead885cf9cbc7b80f5bb9dea13d14e0b5cd56bad5f2895f
 SHA512:
-  metadata.gz: 1c5bd392180f81e5b7cbf5792465faadb4ec1f8694afe3cbc7da22a49068f877dc1337eec26e656b1c4c7249b3af865bda9278930a62e4955fcdc8d24ffa879f
-  data.tar.gz: 578c90d2dc71d6165e3a3912edb8fc081847ff0d96a44cccb3c4e29dd99c8a2b52dd61385bd95aa446d91faf27b501b8e2dc4c124c363011469ee9ffef349829
+  metadata.gz: 568da76f00586978646d74b5a85d0ea7ab3acf2228a4f321b848a4fdd1d517abad9b3712717ac4f96a29aae689e797b7a8182dc9887deda7ed703f7a71c46e79
+  data.tar.gz: d8b8e997e3c4677bd4992528e7a6b5b851f9cdab9ee706f27908b134b4fc27b2990946ddf94cc6807bae61616aba0a23cddb8ae02942c8ae8b3fd7063adb8c5e

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-retail_v2
 
+### v0.102.0 (2024-09-29)
+
+* Regenerated from discovery document revision 20240920
+
+### v0.101.0 (2024-09-22)
+
+* Regenerated from discovery document revision 20240912
+
 ### v0.100.0 (2024-09-01)
 
 * Regenerated from discovery document revision 20240822

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

@@ -560,6 +560,44 @@ module Google
         end
       end
       
+      # Request for BatchUpdateGenerativeQuestionConfig method.
+      class GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The updates question configs.
+        # Corresponds to the JSON property `requests`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2UpdateGenerativeQuestionConfigRequest>]
+        attr_accessor :requests
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @requests = args[:requests] if args.key?(:requests)
+        end
+      end
+      
+      # Aggregated response for UpdateGenerativeQuestionConfig method.
+      class GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The updates question configs.
+        # Corresponds to the JSON property `generativeQuestionConfigs`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig>]
+        attr_accessor :generative_question_configs
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @generative_question_configs = args[:generative_question_configs] if args.key?(:generative_question_configs)
+        end
+      end
+      
       # A BigQuery output result.
       class GoogleCloudRetailV2BigQueryOutputResult
         include Google::Apis::Core::Hashable
@@ -1805,6 +1843,99 @@ module Google
         end
       end
       
+      # Configuration for a single generated question.
+      class GoogleCloudRetailV2GenerativeQuestionConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Whether the question is asked at serving time.
+        # Corresponds to the JSON property `allowedInConversation`
+        # @return [Boolean]
+        attr_accessor :allowed_in_conversation
+        alias_method :allowed_in_conversation?, :allowed_in_conversation
+      
+        # Required. Resource name of the catalog. Format: projects/`project`/locations/`
+        # location`/catalogs/`catalog`
+        # Corresponds to the JSON property `catalog`
+        # @return [String]
+        attr_accessor :catalog
+      
+        # Output only. Values that can be used to answer the question.
+        # Corresponds to the JSON property `exampleValues`
+        # @return [Array<String>]
+        attr_accessor :example_values
+      
+        # Required. The facet to which the question is associated.
+        # Corresponds to the JSON property `facet`
+        # @return [String]
+        attr_accessor :facet
+      
+        # Optional. The question that will be used at serving time. Question can have a
+        # max length of 300 bytes. When not populated, generated_question should be used.
+        # Corresponds to the JSON property `finalQuestion`
+        # @return [String]
+        attr_accessor :final_question
+      
+        # Output only. The ratio of how often a question was asked.
+        # Corresponds to the JSON property `frequency`
+        # @return [Float]
+        attr_accessor :frequency
+      
+        # Output only. The LLM generated question.
+        # Corresponds to the JSON property `generatedQuestion`
+        # @return [String]
+        attr_accessor :generated_question
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allowed_in_conversation = args[:allowed_in_conversation] if args.key?(:allowed_in_conversation)
+          @catalog = args[:catalog] if args.key?(:catalog)
+          @example_values = args[:example_values] if args.key?(:example_values)
+          @facet = args[:facet] if args.key?(:facet)
+          @final_question = args[:final_question] if args.key?(:final_question)
+          @frequency = args[:frequency] if args.key?(:frequency)
+          @generated_question = args[:generated_question] if args.key?(:generated_question)
+        end
+      end
+      
+      # Configuration for overall generative question feature state.
+      class GoogleCloudRetailV2GenerativeQuestionsFeatureConfig
+        include Google::Apis::Core::Hashable
+      
+        # Required. Resource name of the affected catalog. Format: projects/`project`/
+        # locations/`location`/catalogs/`catalog`
+        # Corresponds to the JSON property `catalog`
+        # @return [String]
+        attr_accessor :catalog
+      
+        # Optional. Determines whether questions will be used at serving time. Note:
+        # This feature cannot be enabled until initial data requirements are satisfied.
+        # Corresponds to the JSON property `featureEnabled`
+        # @return [Boolean]
+        attr_accessor :feature_enabled
+        alias_method :feature_enabled?, :feature_enabled
+      
+        # Optional. Minimum number of products in the response to trigger follow-up
+        # questions. Value must be 0 or positive.
+        # Corresponds to the JSON property `minimumProducts`
+        # @return [Fixnum]
+        attr_accessor :minimum_products
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @catalog = args[:catalog] if args.key?(:catalog)
+          @feature_enabled = args[:feature_enabled] if args.key?(:feature_enabled)
+          @minimum_products = args[:minimum_products] if args.key?(:minimum_products)
+        end
+      end
+      
       # Response message of CatalogService.GetDefaultBranch.
       class GoogleCloudRetailV2GetDefaultBranchResponse
         include Google::Apis::Core::Hashable
@@ -2235,6 +2366,25 @@ module Google
         end
       end
       
+      # Response for ListQuestions method.
+      class GoogleCloudRetailV2ListGenerativeQuestionConfigsResponse
+        include Google::Apis::Core::Hashable
+      
+        # All the questions for a given catalog.
+        # Corresponds to the JSON property `generativeQuestionConfigs`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig>]
+        attr_accessor :generative_question_configs
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @generative_question_configs = args[:generative_question_configs] if args.key?(:generative_question_configs)
+        end
+      end
+      
       # Response to a ListModelRequest.
       class GoogleCloudRetailV2ListModelsResponse
         include Google::Apis::Core::Hashable
@@ -3365,6 +3515,58 @@ module Google
         end
       end
       
+      # Product attribute name and numeric interval.
+      class GoogleCloudRetailV2ProductAttributeInterval
+        include Google::Apis::Core::Hashable
+      
+        # A floating point interval.
+        # Corresponds to the JSON property `interval`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2Interval]
+        attr_accessor :interval
+      
+        # The attribute name (e.g. "length")
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @interval = args[:interval] if args.key?(:interval)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # Product attribute which structured by an attribute name and value. This
+      # structure is used in conversational search filters and answers. For example,
+      # if we have `name=color` and `value=red`, this means that the color is `red`.
+      class GoogleCloudRetailV2ProductAttributeValue
+        include Google::Apis::Core::Hashable
+      
+        # The attribute name.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The attribute value.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # Detailed product information associated with a user event.
       class GoogleCloudRetailV2ProductDetail
         include Google::Apis::Core::Hashable
@@ -4538,6 +4740,12 @@ module Google
         # @return [String]
         attr_accessor :canonical_filter
       
+        # This field specifies all conversational related parameters addition to
+        # traditional retail search.
+        # Corresponds to the JSON property `conversationalSearchSpec`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestConversationalSearchSpec]
+        attr_accessor :conversational_search_spec
+      
         # The specifications of dynamically generated facets.
         # Corresponds to the JSON property `dynamicFacetSpec`
         # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestDynamicFacetSpec]
@@ -4654,6 +4862,11 @@ module Google
         # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestSpellCorrectionSpec]
         attr_accessor :spell_correction_spec
       
+        # This field specifies tile navigation related parameters.
+        # Corresponds to the JSON property `tileNavigationSpec`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestTileNavigationSpec]
+        attr_accessor :tile_navigation_spec
+      
         # Information of an end user.
         # Corresponds to the JSON property `userInfo`
         # @return [Google::Apis::RetailV2::GoogleCloudRetailV2UserInfo]
@@ -4708,6 +4921,7 @@ module Google
           @boost_spec = args[:boost_spec] if args.key?(:boost_spec)
           @branch = args[:branch] if args.key?(:branch)
           @canonical_filter = args[:canonical_filter] if args.key?(:canonical_filter)
+          @conversational_search_spec = args[:conversational_search_spec] if args.key?(:conversational_search_spec)
           @dynamic_facet_spec = args[:dynamic_facet_spec] if args.key?(:dynamic_facet_spec)
           @entity = args[:entity] if args.key?(:entity)
           @facet_specs = args[:facet_specs] if args.key?(:facet_specs)
@@ -4723,6 +4937,7 @@ module Google
           @query_expansion_spec = args[:query_expansion_spec] if args.key?(:query_expansion_spec)
           @search_mode = args[:search_mode] if args.key?(:search_mode)
           @spell_correction_spec = args[:spell_correction_spec] if args.key?(:spell_correction_spec)
+          @tile_navigation_spec = args[:tile_navigation_spec] if args.key?(:tile_navigation_spec)
           @user_info = args[:user_info] if args.key?(:user_info)
           @variant_rollup_keys = args[:variant_rollup_keys] if args.key?(:variant_rollup_keys)
           @visitor_id = args[:visitor_id] if args.key?(:visitor_id)
@@ -4798,6 +5013,102 @@ module Google
         end
       end
       
+      # This field specifies all conversational related parameters addition to
+      # traditional retail search.
+      class GoogleCloudRetailV2SearchRequestConversationalSearchSpec
+        include Google::Apis::Core::Hashable
+      
+        # This field specifies the conversation id, which maintains the state of the
+        # conversation between client side and server side. Use the value from the
+        # previous ConversationalSearchResult.conversation_id. For the initial request,
+        # this should be empty.
+        # Corresponds to the JSON property `conversationId`
+        # @return [String]
+        attr_accessor :conversation_id
+      
+        # This field specifies whether the customer would like to do conversational
+        # search. If this field is set to true, conversational related extra information
+        # will be returned from server side, including follow-up question, answer
+        # options, etc.
+        # Corresponds to the JSON property `followupConversationRequested`
+        # @return [Boolean]
+        attr_accessor :followup_conversation_requested
+        alias_method :followup_conversation_requested?, :followup_conversation_requested
+      
+        # This field specifies the current user answer during the conversational search.
+        # This can be either user selected from suggested answers or user input plain
+        # text.
+        # Corresponds to the JSON property `userAnswer`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswer]
+        attr_accessor :user_answer
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @conversation_id = args[:conversation_id] if args.key?(:conversation_id)
+          @followup_conversation_requested = args[:followup_conversation_requested] if args.key?(:followup_conversation_requested)
+          @user_answer = args[:user_answer] if args.key?(:user_answer)
+        end
+      end
+      
+      # This field specifies the current user answer during the conversational search.
+      # This can be either user selected from suggested answers or user input plain
+      # text.
+      class GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswer
+        include Google::Apis::Core::Hashable
+      
+        # This field specifies the selected answers during the conversational search.
+        # Corresponds to the JSON property `selectedAnswer`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswerSelectedAnswer]
+        attr_accessor :selected_answer
+      
+        # This field specifies the incremental input text from the user during the
+        # conversational search.
+        # Corresponds to the JSON property `textAnswer`
+        # @return [String]
+        attr_accessor :text_answer
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @selected_answer = args[:selected_answer] if args.key?(:selected_answer)
+          @text_answer = args[:text_answer] if args.key?(:text_answer)
+        end
+      end
+      
+      # This field specifies the selected answers during the conversational search.
+      class GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswerSelectedAnswer
+        include Google::Apis::Core::Hashable
+      
+        # Product attribute which structured by an attribute name and value. This
+        # structure is used in conversational search filters and answers. For example,
+        # if we have `name=color` and `value=red`, this means that the color is `red`.
+        # Corresponds to the JSON property `productAttributeValue`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue]
+        attr_accessor :product_attribute_value
+      
+        # This field is deprecated and should not be set.
+        # Corresponds to the JSON property `productAttributeValues`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue>]
+        attr_accessor :product_attribute_values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @product_attribute_value = args[:product_attribute_value] if args.key?(:product_attribute_value)
+          @product_attribute_values = args[:product_attribute_values] if args.key?(:product_attribute_values)
+        end
+      end
+      
       # The specifications of dynamically generated facets.
       class GoogleCloudRetailV2SearchRequestDynamicFacetSpec
         include Google::Apis::Core::Hashable
@@ -5076,6 +5387,35 @@ module Google
         end
       end
       
+      # This field specifies tile navigation related parameters.
+      class GoogleCloudRetailV2SearchRequestTileNavigationSpec
+        include Google::Apis::Core::Hashable
+      
+        # This field specifies the tiles which are already clicked in client side. NOTE:
+        # This field is not being used for filtering search products. Client side should
+        # also put all the applied tiles in SearchRequest.filter.
+        # Corresponds to the JSON property `appliedTiles`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2Tile>]
+        attr_accessor :applied_tiles
+      
+        # This field specifies whether the customer would like to request tile
+        # navigation.
+        # Corresponds to the JSON property `tileNavigationRequested`
+        # @return [Boolean]
+        attr_accessor :tile_navigation_requested
+        alias_method :tile_navigation_requested?, :tile_navigation_requested
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @applied_tiles = args[:applied_tiles] if args.key?(:applied_tiles)
+          @tile_navigation_requested = args[:tile_navigation_requested] if args.key?(:tile_navigation_requested)
+        end
+      end
+      
       # Response message for SearchService.Search method.
       class GoogleCloudRetailV2SearchResponse
         include Google::Apis::Core::Hashable
@@ -5093,6 +5433,12 @@ module Google
         # @return [String]
         attr_accessor :attribution_token
       
+        # This field specifies all related information that is needed on client side for
+        # UI rendering of conversational retail search.
+        # Corresponds to the JSON property `conversationalSearchResult`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResult]
+        attr_accessor :conversational_search_result
+      
         # Contains the spell corrected query, if found. If the spell correction type is
         # AUTOMATIC, then the search results are based on corrected_query. Otherwise the
         # original query is used for search.
@@ -5141,6 +5487,12 @@ module Google
         # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseSearchResult>]
         attr_accessor :results
       
+        # This field specifies all related information for tile navigation that will be
+        # used in client side.
+        # Corresponds to the JSON property `tileNavigationResult`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseTileNavigationResult]
+        attr_accessor :tile_navigation_result
+      
         # The estimated total count of matched items irrespective of pagination. The
         # count of results returned by pagination may be less than the total_size that
         # matches.
@@ -5156,6 +5508,7 @@ module Google
         def update!(**args)
           @applied_controls = args[:applied_controls] if args.key?(:applied_controls)
           @attribution_token = args[:attribution_token] if args.key?(:attribution_token)
+          @conversational_search_result = args[:conversational_search_result] if args.key?(:conversational_search_result)
           @corrected_query = args[:corrected_query] if args.key?(:corrected_query)
           @experiment_info = args[:experiment_info] if args.key?(:experiment_info)
           @facets = args[:facets] if args.key?(:facets)
@@ -5164,10 +5517,113 @@ 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)
+          @tile_navigation_result = args[:tile_navigation_result] if args.key?(:tile_navigation_result)
           @total_size = args[:total_size] if args.key?(:total_size)
         end
       end
       
+      # This field specifies all related information that is needed on client side for
+      # UI rendering of conversational retail search.
+      class GoogleCloudRetailV2SearchResponseConversationalSearchResult
+        include Google::Apis::Core::Hashable
+      
+        # Additional filter that client side need to apply.
+        # Corresponds to the JSON property `additionalFilter`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResultAdditionalFilter]
+        attr_accessor :additional_filter
+      
+        # This field is deprecated but will be kept for backward compatibility. There is
+        # expected to have only one additional filter and the value will be the same to
+        # the same as field `additional_filter`.
+        # Corresponds to the JSON property `additionalFilters`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResultAdditionalFilter>]
+        attr_accessor :additional_filters
+      
+        # Conversation UUID. This field will be stored in client side storage to
+        # maintain the conversation session with server and will be used for next search
+        # request's SearchRequest.ConversationalSearchSpec.conversation_id to restore
+        # conversation state in server.
+        # Corresponds to the JSON property `conversationId`
+        # @return [String]
+        attr_accessor :conversation_id
+      
+        # The follow-up question. e.g., `What is the color?`
+        # Corresponds to the JSON property `followupQuestion`
+        # @return [String]
+        attr_accessor :followup_question
+      
+        # The current refined query for the conversational search. This field will be
+        # used in customer UI that the query in the search bar should be replaced with
+        # the refined query. For example, if SearchRequest.query is `dress` and next
+        # SearchRequest.ConversationalSearchSpec.UserAnswer.text_answer is `red color`,
+        # which does not match any product attribute value filters, the refined query
+        # will be `dress, red color`.
+        # Corresponds to the JSON property `refinedQuery`
+        # @return [String]
+        attr_accessor :refined_query
+      
+        # The answer options provided to client for the follow-up question.
+        # Corresponds to the JSON property `suggestedAnswers`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResultSuggestedAnswer>]
+        attr_accessor :suggested_answers
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @additional_filter = args[:additional_filter] if args.key?(:additional_filter)
+          @additional_filters = args[:additional_filters] if args.key?(:additional_filters)
+          @conversation_id = args[:conversation_id] if args.key?(:conversation_id)
+          @followup_question = args[:followup_question] if args.key?(:followup_question)
+          @refined_query = args[:refined_query] if args.key?(:refined_query)
+          @suggested_answers = args[:suggested_answers] if args.key?(:suggested_answers)
+        end
+      end
+      
+      # Additional filter that client side need to apply.
+      class GoogleCloudRetailV2SearchResponseConversationalSearchResultAdditionalFilter
+        include Google::Apis::Core::Hashable
+      
+        # Product attribute which structured by an attribute name and value. This
+        # structure is used in conversational search filters and answers. For example,
+        # if we have `name=color` and `value=red`, this means that the color is `red`.
+        # Corresponds to the JSON property `productAttributeValue`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue]
+        attr_accessor :product_attribute_value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @product_attribute_value = args[:product_attribute_value] if args.key?(:product_attribute_value)
+        end
+      end
+      
+      # Suggested answers to the follow-up question.
+      class GoogleCloudRetailV2SearchResponseConversationalSearchResultSuggestedAnswer
+        include Google::Apis::Core::Hashable
+      
+        # Product attribute which structured by an attribute name and value. This
+        # structure is used in conversational search filters and answers. For example,
+        # if we have `name=color` and `value=red`, this means that the color is `red`.
+        # Corresponds to the JSON property `productAttributeValue`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue]
+        attr_accessor :product_attribute_value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @product_attribute_value = args[:product_attribute_value] if args.key?(:product_attribute_value)
+        end
+      end
+      
       # A facet result.
       class GoogleCloudRetailV2SearchResponseFacet
         include Google::Apis::Core::Hashable
@@ -5343,6 +5799,26 @@ module Google
         end
       end
       
+      # This field specifies all related information for tile navigation that will be
+      # used in client side.
+      class GoogleCloudRetailV2SearchResponseTileNavigationResult
+        include Google::Apis::Core::Hashable
+      
+        # The current tiles that are used for tile navigation, sorted by engagement.
+        # Corresponds to the JSON property `tiles`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2Tile>]
+        attr_accessor :tiles
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @tiles = args[:tiles] if args.key?(:tiles)
+        end
+      end
+      
       # Configures metadata that is used to generate serving time results (e.g. search
       # results or recommendation predictions).
       class GoogleCloudRetailV2ServingConfig
@@ -5653,6 +6129,41 @@ module Google
         end
       end
       
+      # This field specifies the tile information including an attribute key,
+      # attribute value. More fields will be added in the future, eg: product id or
+      # product counts, etc.
+      class GoogleCloudRetailV2Tile
+        include Google::Apis::Core::Hashable
+      
+        # Product attribute name and numeric interval.
+        # Corresponds to the JSON property `productAttributeInterval`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeInterval]
+        attr_accessor :product_attribute_interval
+      
+        # Product attribute which structured by an attribute name and value. This
+        # structure is used in conversational search filters and answers. For example,
+        # if we have `name=color` and `value=red`, this means that the color is `red`.
+        # Corresponds to the JSON property `productAttributeValue`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue]
+        attr_accessor :product_attribute_value
+      
+        # The representative product id for this tile.
+        # Corresponds to the JSON property `representativeProductId`
+        # @return [String]
+        attr_accessor :representative_product_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @product_attribute_interval = args[:product_attribute_interval] if args.key?(:product_attribute_interval)
+          @product_attribute_value = args[:product_attribute_value] if args.key?(:product_attribute_value)
+          @representative_product_id = args[:representative_product_id] if args.key?(:representative_product_id)
+        end
+      end
+      
       # Metadata associated with a tune operation.
       class GoogleCloudRetailV2TuneModelMetadata
         include Google::Apis::Core::Hashable
@@ -5701,6 +6212,33 @@ module Google
         end
       end
       
+      # Request for UpdateGenerativeQuestionConfig method.
+      class GoogleCloudRetailV2UpdateGenerativeQuestionConfigRequest
+        include Google::Apis::Core::Hashable
+      
+        # Configuration for a single generated question.
+        # Corresponds to the JSON property `generativeQuestionConfig`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig]
+        attr_accessor :generative_question_config
+      
+        # Optional. Indicates which fields in the provided GenerativeQuestionConfig to
+        # update. The following are NOT supported: * GenerativeQuestionConfig.frequency
+        # If not set or empty, all supported fields are updated.
+        # Corresponds to the JSON property `updateMask`
+        # @return [String]
+        attr_accessor :update_mask
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @generative_question_config = args[:generative_question_config] if args.key?(:generative_question_config)
+          @update_mask = args[:update_mask] if args.key?(:update_mask)
+        end
+      end
+      
       # UserEvent captures all metadata information Retail API needs to know about how
       # end users interact with customers' website.
       class GoogleCloudRetailV2UserEvent

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module RetailV2
       # Version of the google-apis-retail_v2 gem
-      GEM_VERSION = "0.100.0"
+      GEM_VERSION = "0.102.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 = "20240822"
+      REVISION = "20240920"
     end
   end
 end

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

@@ -124,6 +124,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2BigQueryOutputResult
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -316,6 +328,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2GenerativeQuestionConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2GenerativeQuestionsFeatureConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2GetDefaultBranchResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -394,6 +418,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2ListGenerativeQuestionConfigsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2ListModelsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -508,6 +538,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2ProductAttributeInterval
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2ProductAttributeValue
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2ProductDetail
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -754,6 +796,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2SearchRequestConversationalSearchSpec
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswer
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswerSelectedAnswer
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2SearchRequestDynamicFacetSpec
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -790,12 +850,36 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2SearchRequestTileNavigationSpec
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2SearchResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2SearchResponseConversationalSearchResult
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2SearchResponseConversationalSearchResultAdditionalFilter
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2SearchResponseConversationalSearchResultSuggestedAnswer
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2SearchResponseFacet
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -820,6 +904,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2SearchResponseTileNavigationResult
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2ServingConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -850,6 +940,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2Tile
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2TuneModelMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -868,6 +964,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2UpdateGenerativeQuestionConfigRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2UserEvent
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1573,6 +1675,22 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :requests, as: 'requests', class: Google::Apis::RetailV2::GoogleCloudRetailV2UpdateGenerativeQuestionConfigRequest, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2UpdateGenerativeQuestionConfigRequest::Representation
+      
+        end
+      end
+      
+      class GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :generative_question_configs, as: 'generativeQuestionConfigs', class: Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig::Representation
+      
+        end
+      end
+      
       class GoogleCloudRetailV2BigQueryOutputResult
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1882,6 +2000,28 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2GenerativeQuestionConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :allowed_in_conversation, as: 'allowedInConversation'
+          property :catalog, as: 'catalog'
+          collection :example_values, as: 'exampleValues'
+          property :facet, as: 'facet'
+          property :final_question, as: 'finalQuestion'
+          property :frequency, as: 'frequency'
+          property :generated_question, as: 'generatedQuestion'
+        end
+      end
+      
+      class GoogleCloudRetailV2GenerativeQuestionsFeatureConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :catalog, as: 'catalog'
+          property :feature_enabled, as: 'featureEnabled'
+          property :minimum_products, as: 'minimumProducts'
+        end
+      end
+      
       class GoogleCloudRetailV2GetDefaultBranchResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2010,6 +2150,14 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2ListGenerativeQuestionConfigsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :generative_question_configs, as: 'generativeQuestionConfigs', class: Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig::Representation
+      
+        end
+      end
+      
       class GoogleCloudRetailV2ListModelsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2243,6 +2391,23 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2ProductAttributeInterval
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :interval, as: 'interval', class: Google::Apis::RetailV2::GoogleCloudRetailV2Interval, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2Interval::Representation
+      
+          property :name, as: 'name'
+        end
+      end
+      
+      class GoogleCloudRetailV2ProductAttributeValue
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :value, as: 'value'
+        end
+      end
+      
       class GoogleCloudRetailV2ProductDetail
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2567,6 +2732,8 @@ module Google
       
           property :branch, as: 'branch'
           property :canonical_filter, as: 'canonicalFilter'
+          property :conversational_search_spec, as: 'conversationalSearchSpec', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestConversationalSearchSpec, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestConversationalSearchSpec::Representation
+      
           property :dynamic_facet_spec, as: 'dynamicFacetSpec', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestDynamicFacetSpec, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestDynamicFacetSpec::Representation
       
           property :entity, as: 'entity'
@@ -2587,6 +2754,8 @@ module Google
           property :search_mode, as: 'searchMode'
           property :spell_correction_spec, as: 'spellCorrectionSpec', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestSpellCorrectionSpec, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestSpellCorrectionSpec::Representation
       
+          property :tile_navigation_spec, as: 'tileNavigationSpec', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestTileNavigationSpec, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestTileNavigationSpec::Representation
+      
           property :user_info, as: 'userInfo', class: Google::Apis::RetailV2::GoogleCloudRetailV2UserInfo, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2UserInfo::Representation
       
           collection :variant_rollup_keys, as: 'variantRollupKeys'
@@ -2611,6 +2780,35 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2SearchRequestConversationalSearchSpec
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :conversation_id, as: 'conversationId'
+          property :followup_conversation_requested, as: 'followupConversationRequested'
+          property :user_answer, as: 'userAnswer', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswer, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswer::Representation
+      
+        end
+      end
+      
+      class GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswer
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :selected_answer, as: 'selectedAnswer', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswerSelectedAnswer, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswerSelectedAnswer::Representation
+      
+          property :text_answer, as: 'textAnswer'
+        end
+      end
+      
+      class GoogleCloudRetailV2SearchRequestConversationalSearchSpecUserAnswerSelectedAnswer
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :product_attribute_value, as: 'productAttributeValue', class: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue::Representation
+      
+          collection :product_attribute_values, as: 'productAttributeValues', class: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue::Representation
+      
+        end
+      end
+      
       class GoogleCloudRetailV2SearchRequestDynamicFacetSpec
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2667,11 +2865,22 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2SearchRequestTileNavigationSpec
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :applied_tiles, as: 'appliedTiles', class: Google::Apis::RetailV2::GoogleCloudRetailV2Tile, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2Tile::Representation
+      
+          property :tile_navigation_requested, as: 'tileNavigationRequested'
+        end
+      end
+      
       class GoogleCloudRetailV2SearchResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           collection :applied_controls, as: 'appliedControls'
           property :attribution_token, as: 'attributionToken'
+          property :conversational_search_result, as: 'conversationalSearchResult', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResult, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResult::Representation
+      
           property :corrected_query, as: 'correctedQuery'
           collection :experiment_info, as: 'experimentInfo', class: Google::Apis::RetailV2::GoogleCloudRetailV2ExperimentInfo, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2ExperimentInfo::Representation
       
@@ -2685,10 +2894,43 @@ module Google
           property :redirect_uri, as: 'redirectUri'
           collection :results, as: 'results', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseSearchResult, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseSearchResult::Representation
       
+          property :tile_navigation_result, as: 'tileNavigationResult', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseTileNavigationResult, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseTileNavigationResult::Representation
+      
           property :total_size, as: 'totalSize'
         end
       end
       
+      class GoogleCloudRetailV2SearchResponseConversationalSearchResult
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :additional_filter, as: 'additionalFilter', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResultAdditionalFilter, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResultAdditionalFilter::Representation
+      
+          collection :additional_filters, as: 'additionalFilters', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResultAdditionalFilter, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResultAdditionalFilter::Representation
+      
+          property :conversation_id, as: 'conversationId'
+          property :followup_question, as: 'followupQuestion'
+          property :refined_query, as: 'refinedQuery'
+          collection :suggested_answers, as: 'suggestedAnswers', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResultSuggestedAnswer, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchResponseConversationalSearchResultSuggestedAnswer::Representation
+      
+        end
+      end
+      
+      class GoogleCloudRetailV2SearchResponseConversationalSearchResultAdditionalFilter
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :product_attribute_value, as: 'productAttributeValue', class: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue::Representation
+      
+        end
+      end
+      
+      class GoogleCloudRetailV2SearchResponseConversationalSearchResultSuggestedAnswer
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :product_attribute_value, as: 'productAttributeValue', class: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue::Representation
+      
+        end
+      end
+      
       class GoogleCloudRetailV2SearchResponseFacet
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2732,6 +2974,14 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2SearchResponseTileNavigationResult
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :tiles, as: 'tiles', class: Google::Apis::RetailV2::GoogleCloudRetailV2Tile, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2Tile::Representation
+      
+        end
+      end
+      
       class GoogleCloudRetailV2ServingConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2792,6 +3042,17 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2Tile
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :product_attribute_interval, as: 'productAttributeInterval', class: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeInterval, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeInterval::Representation
+      
+          property :product_attribute_value, as: 'productAttributeValue', class: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2ProductAttributeValue::Representation
+      
+          property :representative_product_id, as: 'representativeProductId'
+        end
+      end
+      
       class GoogleCloudRetailV2TuneModelMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2811,6 +3072,15 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2UpdateGenerativeQuestionConfigRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :generative_question_config, as: 'generativeQuestionConfig', class: Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig::Representation
+      
+          property :update_mask, as: 'updateMask'
+        end
+      end
+      
       class GoogleCloudRetailV2UserEvent
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -269,6 +269,38 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Manages overal generative question feature state -- enables toggling feature
+        # on and off.
+        # @param [String] catalog
+        #   Required. Resource name of the parent catalog. Format: projects/`project`/
+        #   locations/`location`/catalogs/`catalog`
+        # @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::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig]
+        #
+        # @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 get_project_location_catalog_generative_question_feature(catalog, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+catalog}/generativeQuestionFeature', options)
+          command.response_representation = Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig::Representation
+          command.response_class = Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig
+          command.params['catalog'] = catalog unless catalog.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists all the Catalogs associated with the project.
         # @param [String] parent
         #   Required. The account resource name with an associated location. If the caller
@@ -486,6 +518,85 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Allows management of individual questions.
+        # @param [String] catalog
+        #   Required. Resource name of the catalog. Format: projects/`project`/locations/`
+        #   location`/catalogs/`catalog`
+        # @param [Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig] google_cloud_retail_v2_generative_question_config_object
+        # @param [String] update_mask
+        #   Optional. Indicates which fields in the provided GenerativeQuestionConfig to
+        #   update. The following are NOT supported: * GenerativeQuestionConfig.frequency
+        #   If not set or empty, all supported fields are updated.
+        # @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::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig]
+        #
+        # @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 update_project_location_catalog_generative_question(catalog, google_cloud_retail_v2_generative_question_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v2/{+catalog}/generativeQuestion', options)
+          command.request_representation = Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig::Representation
+          command.request_object = google_cloud_retail_v2_generative_question_config_object
+          command.response_representation = Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig::Representation
+          command.response_class = Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionConfig
+          command.params['catalog'] = catalog unless catalog.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Manages overal generative question feature state -- enables toggling feature
+        # on and off.
+        # @param [String] catalog
+        #   Required. Resource name of the affected catalog. Format: projects/`project`/
+        #   locations/`location`/catalogs/`catalog`
+        # @param [Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig] google_cloud_retail_v2_generative_questions_feature_config_object
+        # @param [String] update_mask
+        #   Optional. Indicates which fields in the provided
+        #   GenerativeQuestionsFeatureConfig to update. If not set or empty, all supported
+        #   fields are updated.
+        # @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::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig]
+        #
+        # @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 update_project_location_catalog_generative_question_feature(catalog, google_cloud_retail_v2_generative_questions_feature_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v2/{+catalog}/generativeQuestionFeature', options)
+          command.request_representation = Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig::Representation
+          command.request_object = google_cloud_retail_v2_generative_questions_feature_config_object
+          command.response_representation = Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig::Representation
+          command.response_class = Google::Apis::RetailV2::GoogleCloudRetailV2GenerativeQuestionsFeatureConfig
+          command.params['catalog'] = catalog unless catalog.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Adds the specified CatalogAttribute to the AttributesConfig. If the
         # CatalogAttribute to add already exists, an ALREADY_EXISTS error is returned.
         # @param [String] attributes_config
@@ -1405,6 +1516,71 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Allows management of multiple questions.
+        # @param [String] parent
+        #   Optional. Resource name of the parent catalog. Format: projects/`project`/
+        #   locations/`location`/catalogs/`catalog`
+        # @param [Google::Apis::RetailV2::GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsRequest] google_cloud_retail_v2_batch_update_generative_question_configs_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::RetailV2::GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsResponse]
+        #
+        # @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 batch_project_location_catalog_generative_question_update(parent, google_cloud_retail_v2_batch_update_generative_question_configs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+parent}/generativeQuestion:batchUpdate', options)
+          command.request_representation = Google::Apis::RetailV2::GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsRequest::Representation
+          command.request_object = google_cloud_retail_v2_batch_update_generative_question_configs_request_object
+          command.response_representation = Google::Apis::RetailV2::GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsResponse::Representation
+          command.response_class = Google::Apis::RetailV2::GoogleCloudRetailV2BatchUpdateGenerativeQuestionConfigsResponse
+          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
+        
+        # Returns all questions for a given catalog.
+        # @param [String] parent
+        #   Required. Resource name of the parent catalog. Format: projects/`project`/
+        #   locations/`location`/catalogs/`catalog`
+        # @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::RetailV2::GoogleCloudRetailV2ListGenerativeQuestionConfigsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2ListGenerativeQuestionConfigsResponse]
+        #
+        # @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 list_project_location_catalog_generative_questions(parent, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/generativeQuestions', options)
+          command.response_representation = Google::Apis::RetailV2::GoogleCloudRetailV2ListGenerativeQuestionConfigsResponse::Representation
+          command.response_class = Google::Apis::RetailV2::GoogleCloudRetailV2ListGenerativeQuestionConfigsResponse
+          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
+        
         # Creates a new model.
         # @param [String] parent
         #   Required. The parent resource under which to create the model. Format: `

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-retail_v2
 version: !ruby/object:Gem::Version
-  version: 0.100.0
+  version: 0.102.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-09-01 00:00:00.000000000 Z
+date: 2024-09-29 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-retail_v2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2/v0.100.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2/v0.102.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2
 post_install_message: 
 rdoc_options: []