google-cloud-discovery_engine-v1 2.2.0 → 2.3.0

data/proto_docs/google/cloud/discoveryengine/v1/common.rb

@@ -121,6 +121,56 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Principal identifier of a user or a group.
+        # @!attribute [rw] user_id
+        #   @return [::String]
+        #     User identifier.
+        #     For Google Workspace user account, user_id should be the google workspace
+        #     user email.
+        #     For non-google identity provider user account, user_id is the mapped user
+        #     identifier configured during the workforcepool config.
+        #
+        #     Note: The following fields are mutually exclusive: `user_id`, `group_id`, `external_entity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] group_id
+        #   @return [::String]
+        #     Group identifier.
+        #     For Google Workspace user account, group_id should be the google
+        #     workspace group email.
+        #     For non-google identity provider user account, group_id is the mapped
+        #     group identifier configured during the workforcepool config.
+        #
+        #     Note: The following fields are mutually exclusive: `group_id`, `user_id`, `external_entity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] external_entity_id
+        #   @return [::String]
+        #     For 3P application identities which are not present in the customer
+        #     identity provider.
+        #
+        #     Note: The following fields are mutually exclusive: `external_entity_id`, `user_id`, `group_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class Principal
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Config to data store for `HEALTHCARE_FHIR` vertical.
+        # @!attribute [rw] enable_configurable_schema
+        #   @return [::Boolean]
+        #     Whether to enable configurable schema for `HEALTHCARE_FHIR` vertical.
+        #
+        #     If set to `true`, the predefined healthcare fhir schema can be extended
+        #     for more customized searching and filtering.
+        # @!attribute [rw] enable_static_indexing_for_batch_ingestion
+        #   @return [::Boolean]
+        #     Whether to enable static indexing for `HEALTHCARE_FHIR` batch
+        #     ingestion.
+        #
+        #     If set to `true`, the batch ingestion will be processed in a static
+        #     indexing mode which is slower but more capable of handling larger
+        #     volume.
+        class HealthcareFhirConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Promotion proto includes uri and other helping information to display the
         # promotion.
         # @!attribute [rw] title
@@ -131,6 +181,11 @@ module Google
         #   @return [::String]
         #     Optional. The URL for the page the user wants to promote. Must be set for
         #     site search. For other verticals, this is optional.
+        # @!attribute [rw] document
+        #   @return [::String]
+        #     Optional. The {::Google::Cloud::DiscoveryEngine::V1::Document Document} the user
+        #     wants to promote. For site search, leave unset and only populate uri. Can
+        #     be set along with uri.
         # @!attribute [rw] image_uri
         #   @return [::String]
         #     Optional. The promotion thumbnail image url.

data/proto_docs/google/cloud/discoveryengine/v1/control.rb

@@ -41,7 +41,7 @@ module Google
         #     Optional. Query regex to match the whole search query.
         #     Cannot be set when
         #     {::Google::Cloud::DiscoveryEngine::V1::Condition#query_terms Condition.query_terms}
-        #     is set. This is currently supporting promotion use case.
+        #     is set. Only supported for Basic Site Search promotion serving controls.
         class Condition
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -110,8 +110,6 @@ module Google
         #   @return [::Google::Cloud::DiscoveryEngine::V1::Control::PromoteAction]
         #     Promote certain links based on predefined trigger queries.
         #
-        #     This now only supports basic site search.
-        #
         #     Note: The following fields are mutually exclusive: `promote_action`, `boost_action`, `filter_action`, `redirect_action`, `synonyms_action`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] name
         #   @return [::String]

data/proto_docs/google/cloud/discoveryengine/v1/conversational_search_service.rb

@@ -721,6 +721,9 @@ module Google
 
                 # Non-answer-seeking query classification type, for no clear intent.
                 NON_ANSWER_SEEKING_QUERY_V2 = 4
+
+                # User defined query classification type.
+                USER_DEFINED_CLASSIFICATION_QUERY = 5
               end
             end
 

data/proto_docs/google/cloud/discoveryengine/v1/data_store.rb

@@ -24,7 +24,7 @@ module Google
         # DataStore captures global settings and configs at the DataStore level.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Immutable. The full resource name of the data store.
+        #     Immutable. Identifier. The full resource name of the data store.
         #     Format:
         #     `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.
         #
@@ -64,9 +64,41 @@ module Google
         # @!attribute [rw] advanced_site_search_config
         #   @return [::Google::Cloud::DiscoveryEngine::V1::AdvancedSiteSearchConfig]
         #     Optional. Configuration for advanced site search.
+        # @!attribute [rw] kms_key_name
+        #   @return [::String]
+        #     Input only. The KMS key to be used to protect this DataStore at creation
+        #     time.
+        #
+        #     Must be set for requests that need to comply with CMEK Org Policy
+        #     protections.
+        #
+        #     If this field is set and processed successfully, the DataStore will be
+        #     protected by the KMS key, as indicated in the cmek_config field.
+        # @!attribute [r] cmek_config
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::CmekConfig]
+        #     Output only. CMEK-related information for the DataStore.
         # @!attribute [r] billing_estimation
         #   @return [::Google::Cloud::DiscoveryEngine::V1::DataStore::BillingEstimation]
         #     Output only. Data size estimation for billing.
+        # @!attribute [rw] acl_enabled
+        #   @return [::Boolean]
+        #     Immutable. Whether data in the
+        #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore} has ACL information.
+        #     If set to `true`, the source data must have ACL. ACL will be ingested when
+        #     data is ingested by
+        #     {::Google::Cloud::DiscoveryEngine::V1::DocumentService::Client#import_documents DocumentService.ImportDocuments}
+        #     methods.
+        #
+        #     When ACL is enabled for the
+        #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore},
+        #     {::Google::Cloud::DiscoveryEngine::V1::Document Document} can't be accessed by
+        #     calling
+        #     {::Google::Cloud::DiscoveryEngine::V1::DocumentService::Client#get_document DocumentService.GetDocument}
+        #     or
+        #     {::Google::Cloud::DiscoveryEngine::V1::DocumentService::Client#list_documents DocumentService.ListDocuments}.
+        #
+        #     Currently ACL is only supported in `GENERIC` industry vertical with
+        #     non-`PUBLIC_WEBSITE` content config.
         # @!attribute [rw] workspace_config
         #   @return [::Google::Cloud::DiscoveryEngine::V1::WorkspaceConfig]
         #     Config to store data store type configuration for workspace data. This
@@ -96,6 +128,16 @@ module Google
         #     The provided schema will be validated against certain rules on schema.
         #     Learn more from [this
         #     doc](https://cloud.google.com/generative-ai-app-builder/docs/provide-schema).
+        # @!attribute [rw] healthcare_fhir_config
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::HealthcareFhirConfig]
+        #     Optional. Configuration for `HEALTHCARE_FHIR` vertical.
+        # @!attribute [rw] identity_mapping_store
+        #   @return [::String]
+        #     Immutable. The fully qualified resource name of the associated
+        #     {::Google::Cloud::DiscoveryEngine::V1::IdentityMappingStore IdentityMappingStore}.
+        #     This field can only be set for acl_enabled DataStores with `THIRD_PARTY` or
+        #     `GSUITE` IdP. Format:
+        #     `projects/{project}/locations/{location}/identityMappingStores/{identity_mapping_store}`.
         class DataStore
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/discoveryengine/v1/data_store_service.rb

@@ -24,6 +24,18 @@ module Google
         # Request for
         # {::Google::Cloud::DiscoveryEngine::V1::DataStoreService::Client#create_data_store DataStoreService.CreateDataStore}
         # method.
+        # @!attribute [rw] cmek_config_name
+        #   @return [::String]
+        #     Resource name of the CmekConfig to use for protecting this DataStore.
+        #
+        #     Note: The following fields are mutually exclusive: `cmek_config_name`, `disable_cmek`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] disable_cmek
+        #   @return [::Boolean]
+        #     DataStore without CMEK protections. If a default CmekConfig is set for
+        #     the project, setting this field will override the default CmekConfig as
+        #     well.
+        #
+        #     Note: The following fields are mutually exclusive: `disable_cmek`, `cmek_config_name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The parent resource name, such as

data/proto_docs/google/cloud/discoveryengine/v1/document.rb

@@ -56,9 +56,8 @@ module Google
         #     The identifier of the schema located in the same data store.
         # @!attribute [rw] content
         #   @return [::Google::Cloud::DiscoveryEngine::V1::Document::Content]
-        #     The unstructured data linked to this document. Content must be set if this
-        #     document is under a
-        #     `CONTENT_REQUIRED` data store.
+        #     The unstructured data linked to this document. Content can only be set
+        #     and must be set if this document is under a `CONTENT_REQUIRED` data store.
         # @!attribute [rw] parent_document_id
         #   @return [::String]
         #     The identifier of the parent document. Currently supports at most two level
@@ -70,6 +69,9 @@ module Google
         #   @return [::Google::Protobuf::Struct]
         #     Output only. This field is OUTPUT_ONLY.
         #     It contains derived data that are not in the original input document.
+        # @!attribute [rw] acl_info
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::Document::AclInfo]
+        #     Access control information for the document.
         # @!attribute [r] index_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The last time the document was indexed. If this field is set,
@@ -116,9 +118,23 @@ module Google
           #
           #     * `application/pdf` (PDF, only native PDFs are supported for now)
           #     * `text/html` (HTML)
+          #     * `text/plain` (TXT)
+          #     * `application/xml` or `text/xml` (XML)
+          #     * `application/json` (JSON)
           #     * `application/vnd.openxmlformats-officedocument.wordprocessingml.document` (DOCX)
           #     * `application/vnd.openxmlformats-officedocument.presentationml.presentation` (PPTX)
-          #     * `text/plain` (TXT)
+          #     * `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`
+          #     (XLSX)
+          #     * `application/vnd.ms-excel.sheet.macroenabled.12` (XLSM)
+          #
+          #     The following types are supported only if layout parser is enabled in the
+          #     data store:
+          #
+          #     * `image/bmp` (BMP)
+          #     * `image/gif` (GIF)
+          #     * `image/jpeg` (JPEG)
+          #     * `image/png` (PNG)
+          #     * `image/tiff` (TIFF)
           #
           #     See https://www.iana.org/assignments/media-types/media-types.xhtml.
           class Content
@@ -126,6 +142,85 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # ACL Information of the Document.
+          # @!attribute [rw] readers
+          #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::Document::AclInfo::AccessRestriction>]
+          #     Readers of the document.
+          class AclInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # AclRestriction to model complex inheritance restrictions.
+            #
+            # Example: Modeling a "Both Permit" inheritance, where to access a
+            # child document, user needs to have access to parent document.
+            #
+            # Document Hierarchy - Space_S --> Page_P.
+            #
+            # Readers:
+            #   Space_S: group_1, user_1
+            #   Page_P: group_2, group_3, user_2
+            #
+            # Space_S ACL Restriction -
+            # {
+            #   "acl_info": {
+            #     "readers": [
+            #       {
+            #         "principals": [
+            #           {
+            #             "group_id": "group_1"
+            #           },
+            #           {
+            #             "user_id": "user_1"
+            #           }
+            #         ]
+            #       }
+            #     ]
+            #   }
+            # }
+            #
+            # Page_P ACL Restriction.
+            # {
+            #   "acl_info": {
+            #     "readers": [
+            #       {
+            #         "principals": [
+            #           {
+            #             "group_id": "group_2"
+            #           },
+            #           {
+            #             "group_id": "group_3"
+            #           },
+            #           {
+            #             "user_id": "user_2"
+            #           }
+            #         ],
+            #       },
+            #       {
+            #         "principals": [
+            #           {
+            #             "group_id": "group_1"
+            #           },
+            #           {
+            #             "user_id": "user_1"
+            #           }
+            #         ],
+            #       }
+            #     ]
+            #   }
+            # }
+            # @!attribute [rw] principals
+            #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1::Principal>]
+            #     List of principals.
+            # @!attribute [rw] idp_wide
+            #   @return [::Boolean]
+            #     All users within the Identity Provider.
+            class AccessRestriction
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
           # Index status of the document.
           # @!attribute [rw] index_time
           #   @return [::Google::Protobuf::Timestamp]

data/proto_docs/google/cloud/discoveryengine/v1/document_processing_config.rb

@@ -132,6 +132,29 @@ module Google
             end
 
             # The layout parsing configurations for documents.
+            # @!attribute [rw] enable_table_annotation
+            #   @return [::Boolean]
+            #     Optional. If true, the LLM based annotation is added to the table
+            #     during parsing.
+            # @!attribute [rw] enable_image_annotation
+            #   @return [::Boolean]
+            #     Optional. If true, the LLM based annotation is added to the image
+            #     during parsing.
+            # @!attribute [rw] structured_content_types
+            #   @return [::Array<::String>]
+            #     Optional. Contains the required structure types to extract from the
+            #     document. Supported values:
+            #
+            #     * `shareholder-structure`
+            # @!attribute [rw] exclude_html_elements
+            #   @return [::Array<::String>]
+            #     Optional. List of HTML elements to exclude from the parsed content.
+            # @!attribute [rw] exclude_html_classes
+            #   @return [::Array<::String>]
+            #     Optional. List of HTML classes to exclude from the parsed content.
+            # @!attribute [rw] exclude_html_ids
+            #   @return [::Array<::String>]
+            #     Optional. List of HTML ids to exclude from the parsed content.
             class LayoutParsingConfig
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/discoveryengine/v1/engine.rb

@@ -29,14 +29,25 @@ module Google
         #     {::Google::Cloud::DiscoveryEngine::V1::Engine#solution_type solution_type} is
         #     {::Google::Cloud::DiscoveryEngine::V1::SolutionType::SOLUTION_TYPE_CHAT SOLUTION_TYPE_CHAT}.
         #
-        #     Note: The following fields are mutually exclusive: `chat_engine_config`, `search_engine_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `chat_engine_config`, `search_engine_config`, `media_recommendation_engine_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] search_engine_config
         #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::SearchEngineConfig]
         #     Configurations for the Search Engine. Only applicable if
         #     {::Google::Cloud::DiscoveryEngine::V1::Engine#solution_type solution_type} is
         #     {::Google::Cloud::DiscoveryEngine::V1::SolutionType::SOLUTION_TYPE_SEARCH SOLUTION_TYPE_SEARCH}.
         #
-        #     Note: The following fields are mutually exclusive: `search_engine_config`, `chat_engine_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `search_engine_config`, `chat_engine_config`, `media_recommendation_engine_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] media_recommendation_engine_config
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::MediaRecommendationEngineConfig]
+        #     Configurations for the Media Engine. Only applicable on the data
+        #     stores with
+        #     {::Google::Cloud::DiscoveryEngine::V1::Engine#solution_type solution_type}
+        #     {::Google::Cloud::DiscoveryEngine::V1::SolutionType::SOLUTION_TYPE_RECOMMENDATION SOLUTION_TYPE_RECOMMENDATION}
+        #     and
+        #     {::Google::Cloud::DiscoveryEngine::V1::IndustryVertical::MEDIA IndustryVertical.MEDIA}
+        #     vertical.
+        #
+        #     Note: The following fields are mutually exclusive: `media_recommendation_engine_config`, `chat_engine_config`, `search_engine_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [r] chat_engine_metadata
         #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::ChatEngineMetadata]
         #     Output only. Additional information of the Chat Engine. Only applicable
@@ -45,7 +56,7 @@ module Google
         #     {::Google::Cloud::DiscoveryEngine::V1::SolutionType::SOLUTION_TYPE_CHAT SOLUTION_TYPE_CHAT}.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Immutable. The fully qualified resource name of the engine.
+        #     Immutable. Identifier. The fully qualified resource name of the engine.
         #
         #     This field must be a UTF-8 encoded string with a length limit of 1024
         #     characters.
@@ -66,7 +77,7 @@ module Google
         #     Output only. Timestamp the Recommendation Engine was last updated.
         # @!attribute [rw] data_store_ids
         #   @return [::Array<::String>]
-        #     The data stores associated with this engine.
+        #     Optional. The data stores associated with this engine.
         #
         #     For
         #     {::Google::Cloud::DiscoveryEngine::V1::SolutionType::SOLUTION_TYPE_SEARCH SOLUTION_TYPE_SEARCH}
@@ -89,7 +100,7 @@ module Google
         #     Required. The solutions of the engine.
         # @!attribute [rw] industry_vertical
         #   @return [::Google::Cloud::DiscoveryEngine::V1::IndustryVertical]
-        #     The industry vertical that the engine registers.
+        #     Optional. The industry vertical that the engine registers.
         #     The restriction of the Engine industry vertical is based on
         #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}: Vertical on Engine
         #     has to match vertical of the DataStore linked to the engine.
@@ -123,6 +134,131 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Additional config specs for a Media Recommendation engine.
+          # @!attribute [rw] type
+          #   @return [::String]
+          #     Required. The type of engine. e.g., `recommended-for-you`.
+          #
+          #     This field together with
+          #     {::Google::Cloud::DiscoveryEngine::V1::Engine::MediaRecommendationEngineConfig#optimization_objective optimization_objective}
+          #     describe engine metadata to use to control engine training and serving.
+          #
+          #     Currently supported values: `recommended-for-you`, `others-you-may-like`,
+          #     `more-like-this`, `most-popular-items`.
+          # @!attribute [rw] optimization_objective
+          #   @return [::String]
+          #     The optimization objective. e.g., `cvr`.
+          #
+          #     This field together with
+          #     {::Google::Cloud::DiscoveryEngine::V1::Engine::MediaRecommendationEngineConfig#type optimization_objective}
+          #     describe engine metadata to use to control engine training and serving.
+          #
+          #     Currently supported
+          #     values: `ctr`, `cvr`.
+          #
+          #      If not specified, we choose default based on engine type.
+          #     Default depends on type of recommendation:
+          #
+          #     `recommended-for-you` => `ctr`
+          #
+          #     `others-you-may-like` => `ctr`
+          # @!attribute [rw] optimization_objective_config
+          #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::MediaRecommendationEngineConfig::OptimizationObjectiveConfig]
+          #     Name and value of the custom threshold for cvr optimization_objective.
+          #     For target_field `watch-time`, target_field_value must be an integer
+          #     value indicating the media progress time in seconds between (0, 86400]
+          #     (excludes 0, includes 86400) (e.g., 90).
+          #     For target_field `watch-percentage`, the target_field_value must be a
+          #     valid float value between (0, 1.0] (excludes 0, includes 1.0) (e.g.,
+          #     0.5).
+          # @!attribute [rw] training_state
+          #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::MediaRecommendationEngineConfig::TrainingState]
+          #     The training state that the engine is in (e.g.
+          #     `TRAINING` or `PAUSED`).
+          #
+          #     Since part of the cost of running the service
+          #     is frequency of training - this can be used to determine when to train
+          #     engine in order to control cost. If not specified: the default value for
+          #     `CreateEngine` method is `TRAINING`. The default value for
+          #     `UpdateEngine` method is to keep the state the same as before.
+          # @!attribute [rw] engine_features_config
+          #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::MediaRecommendationEngineConfig::EngineFeaturesConfig]
+          #     Optional. Additional engine features config.
+          class MediaRecommendationEngineConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Custom threshold for `cvr` optimization_objective.
+            # @!attribute [rw] target_field
+            #   @return [::String]
+            #     Required. The name of the field to target. Currently supported
+            #     values: `watch-percentage`, `watch-time`.
+            # @!attribute [rw] target_field_value_float
+            #   @return [::Float]
+            #     Required. The threshold to be applied to the target (e.g., 0.5).
+            class OptimizationObjectiveConfig
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # More feature configs of the selected engine type.
+            # @!attribute [rw] recommended_for_you_config
+            #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::MediaRecommendationEngineConfig::RecommendedForYouFeatureConfig]
+            #     Recommended for you engine feature config.
+            #
+            #     Note: The following fields are mutually exclusive: `recommended_for_you_config`, `most_popular_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] most_popular_config
+            #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::MediaRecommendationEngineConfig::MostPopularFeatureConfig]
+            #     Most popular engine feature config.
+            #
+            #     Note: The following fields are mutually exclusive: `most_popular_config`, `recommended_for_you_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            class EngineFeaturesConfig
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Additional feature configurations for creating a `recommended-for-you`
+            # engine.
+            # @!attribute [rw] context_event_type
+            #   @return [::String]
+            #     The type of event with which the engine is queried at prediction time.
+            #     If set to `generic`, only `view-item`, `media-play`,and
+            #     `media-complete` will be used as `context-event` in engine training. If
+            #     set to `view-home-page`, `view-home-page` will also be used as
+            #     `context-events` in addition to `view-item`, `media-play`, and
+            #     `media-complete`. Currently supported for the `recommended-for-you`
+            #     engine. Currently supported values: `view-home-page`, `generic`.
+            class RecommendedForYouFeatureConfig
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Feature configurations that are required for creating a Most Popular
+            # engine.
+            # @!attribute [rw] time_window_days
+            #   @return [::Integer]
+            #     The time window of which the engine is queried at training and
+            #     prediction time. Positive integers only. The value translates to the
+            #     last X days of events. Currently required for the `most-popular-items`
+            #     engine.
+            class MostPopularFeatureConfig
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # The training state of the engine.
+            module TrainingState
+              # Unspecified training state.
+              TRAINING_STATE_UNSPECIFIED = 0
+
+              # The engine training is paused.
+              PAUSED = 1
+
+              # The engine is training.
+              TRAINING = 2
+            end
+          end
+
           # Configurations for a Chat Engine.
           # @!attribute [rw] agent_creation_config
           #   @return [::Google::Cloud::DiscoveryEngine::V1::Engine::ChatEngineConfig::AgentCreationConfig]

data/proto_docs/google/cloud/discoveryengine/v1/grounded_generation_service.rb

@@ -476,6 +476,9 @@ module Google
         #     will lead to fewer but very strong citations, while choosing a lower
         #     threshold may lead to more but somewhat weaker citations. If unset, the
         #     threshold will default to 0.6.
+        # @!attribute [rw] enable_claim_level_score
+        #   @return [::Boolean]
+        #     The control flag that enables claim-level grounding score in the response.
         class CheckGroundingSpec
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -601,6 +604,11 @@ module Google
           #     the claim and therefore
           #     {::Google::Cloud::DiscoveryEngine::V1::CheckGroundingResponse::Claim#citation_indices citation_indices}
           #     should not be returned.
+          # @!attribute [rw] score
+          #   @return [::Float]
+          #     Confidence score for the claim in the answer candidate, in the range of
+          #     [0, 1]. This is set only when
+          #     `CheckGroundingRequest.grounding_spec.enable_claim_level_score` is true.
           class Claim
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/discoveryengine/v1/grounding.rb

@@ -60,6 +60,15 @@ module Google
         # @!attribute [rw] source_metadata
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     More fine-grained information for the source reference.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     The URI of the source.
+        # @!attribute [rw] title
+        #   @return [::String]
+        #     The title of the source.
+        # @!attribute [rw] domain
+        #   @return [::String]
+        #     The domain of the source.
         class FactChunk
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/discoveryengine/v1/identity_mapping_store.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module DiscoveryEngine
+      module V1
+        # Identity Mapping Store which contains Identity Mapping Entries.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Immutable. The full resource name of the identity mapping store.
+        #     Format:
+        #     `projects/{project}/locations/{location}/identityMappingStores/{identity_mapping_store}`.
+        #     This field must be a UTF-8 encoded string with a length limit of 1024
+        #     characters.
+        # @!attribute [rw] kms_key_name
+        #   @return [::String]
+        #     Input only. The KMS key to be used to protect this Identity Mapping Store
+        #     at creation time.
+        #
+        #     Must be set for requests that need to comply with CMEK Org Policy
+        #     protections.
+        #
+        #     If this field is set and processed successfully, the Identity Mapping Store
+        #     will be protected by the KMS key, as indicated in the cmek_config field.
+        # @!attribute [r] cmek_config
+        #   @return [::Google::Cloud::DiscoveryEngine::V1::CmekConfig]
+        #     Output only. CMEK-related information for the Identity Mapping Store.
+        class IdentityMappingStore
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Identity Mapping Entry that maps an external identity to an internal
+        # identity.
+        # @!attribute [rw] user_id
+        #   @return [::String]
+        #     User identifier.
+        #     For Google Workspace user account, user_id should be the google workspace
+        #     user email.
+        #     For non-google identity provider, user_id is the mapped user identifier
+        #     configured during the workforcepool config.
+        #
+        #     Note: The following fields are mutually exclusive: `user_id`, `group_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] group_id
+        #   @return [::String]
+        #     Group identifier.
+        #     For Google Workspace user account, group_id should be the google
+        #     workspace group email.
+        #     For non-google identity provider, group_id is the mapped group identifier
+        #     configured during the workforcepool config.
+        #
+        #     Note: The following fields are mutually exclusive: `group_id`, `user_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] external_identity
+        #   @return [::String]
+        #     Required. Identity outside the customer identity provider.
+        #     The length limit of external identity will be of 100 characters.
+        class IdentityMappingEntry
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end