google-cloud-discovery_engine-v1beta 0.11.0 → 0.12.0

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

@@ -0,0 +1,209 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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 V1beta
+        # Defines circumstances to be checked before allowing a behavior
+        # @!attribute [rw] query_terms
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::Condition::QueryTerm>]
+        #     Search only
+        #     A list of terms to match the query on.
+        #
+        #     Maximum of 10 query terms.
+        # @!attribute [rw] active_time_range
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::Condition::TimeRange>]
+        #     Range of time(s) specifying when condition is active.
+        #
+        #     Maximum of 10 time ranges.
+        class Condition
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Matcher for search request query
+          # @!attribute [rw] value
+          #   @return [::String]
+          #     The specific query value to match against
+          #
+          #     Must be lowercase, must be UTF-8.
+          #     Can have at most 3 space separated terms if full_match is true.
+          #     Cannot be an empty string.
+          #     Maximum length of 5000 characters.
+          # @!attribute [rw] full_match
+          #   @return [::Boolean]
+          #     Whether the search query needs to exactly match the query term.
+          class QueryTerm
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Used for time-dependent conditions.
+          # @!attribute [rw] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Start of time range.
+          #
+          #     Range is inclusive.
+          # @!attribute [rw] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     End of time range.
+          #
+          #     Range is inclusive.
+          #     Must be in the future.
+          class TimeRange
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Defines a conditioned behavior to employ during serving.
+        # Must be attached to a
+        # {::Google::Cloud::DiscoveryEngine::V1beta::ServingConfig ServingConfig} to be
+        # considered at serving time. Permitted actions dependent on `SolutionType`.
+        # @!attribute [rw] boost_action
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::BoostAction]
+        #     Defines a boost-type control
+        # @!attribute [rw] filter_action
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::FilterAction]
+        #     Defines a filter-type control
+        #     Currently not supported by Recommendation
+        # @!attribute [rw] redirect_action
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::RedirectAction]
+        #     Defines a redirect-type control.
+        # @!attribute [rw] synonyms_action
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control::SynonymsAction]
+        #     Treats a group of terms as synonyms of one another.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Immutable. Fully qualified name
+        #     `projects/*/locations/global/dataStore/*/controls/*`
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. Human readable name. The identifier used in UI views.
+        #
+        #     Must be UTF-8 encoded string. Length limit is 128 characters.
+        #     Otherwise an INVALID ARGUMENT error is thrown.
+        # @!attribute [r] associated_serving_config_ids
+        #   @return [::Array<::String>]
+        #     Output only. List of all
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::ServingConfig ServingConfig} ids this
+        #     control is attached to. May take up to 10 minutes to update after changes.
+        # @!attribute [rw] solution_type
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::SolutionType]
+        #     Required. Immutable. What solution the control belongs to.
+        #
+        #     Must be compatible with vertical of resource.
+        #     Otherwise an INVALID ARGUMENT error is thrown.
+        # @!attribute [rw] use_cases
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::SearchUseCase>]
+        #     Specifies the use case for the control.
+        #     Affects what condition fields can be set.
+        #     Only applies to
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::SolutionType::SOLUTION_TYPE_SEARCH SOLUTION_TYPE_SEARCH}.
+        #     Currently only allow one use case per control.
+        #     Must be set when solution_type is
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::SolutionType::SOLUTION_TYPE_SEARCH SolutionType.SOLUTION_TYPE_SEARCH}.
+        # @!attribute [rw] conditions
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::Condition>]
+        #     Determines when the associated action will trigger.
+        #
+        #     Omit to always apply the action.
+        #     Currently only a single condition may be specified.
+        #     Otherwise an INVALID ARGUMENT error is thrown.
+        class Control
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Adjusts order of products in returned list.
+          # @!attribute [rw] boost
+          #   @return [::Float]
+          #     Required. Strength of the boost, which should be in [-1, 1]. Negative
+          #     boost means demotion. Default is 0.0 (No-op).
+          # @!attribute [rw] filter
+          #   @return [::String]
+          #     Required. Specifies which products to apply the boost to.
+          #
+          #     If no filter is provided all products will be boosted (No-op).
+          #     Syntax documentation:
+          #     https://cloud.google.com/retail/docs/filter-and-order
+          #     Maximum length is 5000 characters.
+          #     Otherwise an INVALID ARGUMENT error is thrown.
+          # @!attribute [rw] data_store
+          #   @return [::String]
+          #     Required. Specifies which data store's documents can be boosted by this
+          #     control. Full data store name e.g.
+          #     projects/123/locations/global/collections/default_collection/dataStores/default_data_store
+          class BoostAction
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Specified which products may be included in results.
+          # Uses same filter as boost.
+          # @!attribute [rw] filter
+          #   @return [::String]
+          #     Required. A filter to apply on the matching condition results.
+          #
+          #     Required
+          #     Syntax documentation:
+          #     https://cloud.google.com/retail/docs/filter-and-order
+          #     Maximum length is 5000 characters. Otherwise an INVALID
+          #     ARGUMENT error is thrown.
+          # @!attribute [rw] data_store
+          #   @return [::String]
+          #     Required. Specifies which data store's documents can be filtered by this
+          #     control. Full data store name e.g.
+          #     projects/123/locations/global/collections/default_collection/dataStores/default_data_store
+          class FilterAction
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Redirects a shopper to the provided URI.
+          # @!attribute [rw] redirect_uri
+          #   @return [::String]
+          #     Required. The URI to which the shopper will be redirected.
+          #
+          #     Required.
+          #     URI must have length equal or less than 2000 characters.
+          #     Otherwise an INVALID ARGUMENT error is thrown.
+          class RedirectAction
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Creates a set of terms that will act as synonyms of one another.
+          #
+          # Example: "happy" will also be considered as "glad", "glad" will also be
+          # considered as "happy".
+          # @!attribute [rw] synonyms
+          #   @return [::Array<::String>]
+          #     Defines a set of synonyms.
+          #     Can specify up to 100 synonyms.
+          #     Must specify at least 2 synonyms. Otherwise an INVALID ARGUMENT error is
+          #     thrown.
+          class SynonymsAction
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/discoveryengine/v1beta/control_service.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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 V1beta
+        # Request for CreateControl method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. Full resource name of parent data store. Format:
+        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+        #     or
+        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+        # @!attribute [rw] control
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control]
+        #     Required. The Control to create.
+        # @!attribute [rw] control_id
+        #   @return [::String]
+        #     Required. The ID to use for the Control, which will become the final
+        #     component of the Control's resource name.
+        #
+        #     This value must be within 1-63 characters.
+        #     Valid characters are /[a-z][0-9]-_/.
+        class CreateControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for UpdateControl method.
+        # @!attribute [rw] control
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Control]
+        #     Required. The Control to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. Indicates which fields in the provided
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Control Control} to update. The
+        #     following are NOT supported:
+        #
+        #     * {::Google::Cloud::DiscoveryEngine::V1beta::Control#name Control.name}
+        #     * {::Google::Cloud::DiscoveryEngine::V1beta::Control#solution_type Control.solution_type}
+        #
+        #     If not set or empty, all supported fields are updated.
+        class UpdateControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for DeleteControl method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the Control to delete. Format:
+        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+        class DeleteControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for GetControl method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the Control to get. Format:
+        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`
+        class GetControlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for ListControls method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The data store resource name. Format:
+        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}`
+        #     or
+        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Maximum number of results to return. If unspecified, defaults
+        #     to 50. Max allowed value is 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListControls` call.
+        #     Provide this to retrieve the subsequent page.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. A filter to apply on the list results. Supported features:
+        #
+        #     * List all the products under the parent branch if
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::ListControlsRequest#filter filter} is
+        #     unset. Currently this field is unsupported.
+        class ListControlsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for ListControls method.
+        # @!attribute [rw] controls
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::Control>]
+        #     All the Controls for a given data store.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Pagination token, if not returned indicates the last page.
+        class ListControlsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/discoveryengine/v1beta/conversation.rb

@@ -25,9 +25,9 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Immutable. Fully qualified name
-        #     `project/*/locations/global/collections/{collection}/dataStore/*/conversations/*`
+        #     `projects/{project}/locations/global/collections/{collection}/dataStore/*/conversations/*`
         #     or
-        #     `project/*/locations/global/collections/{collection}/engines/*/conversations/*`.
+        #     `projects/{project}/locations/global/collections/{collection}/engines/*/conversations/*`.
         # @!attribute [rw] state
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Conversation::State]
         #     The state of the Conversation.

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

@@ -247,8 +247,8 @@ module Google
         #
         #     When session field is not set, the API is in sessionless mode.
         #
-        #     We support auto session mode: users can use the wildcard symbol “-” as
-        #     session id.  A new id will be automatically generated and assigned.
+        #     We support auto session mode: users can use the wildcard symbol `-` as
+        #     session ID.  A new ID will be automatically generated and assigned.
         # @!attribute [rw] safety_spec
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest::SafetySpec]
         #     Model specification.
@@ -347,6 +347,13 @@ module Google
           #     non-answer seeking query. If this field is set to `true`, we skip
           #     generating answers for non-answer seeking queries and return
           #     fallback messages instead.
+          # @!attribute [rw] ignore_low_relevant_content
+          #   @return [::Boolean]
+          #     Specifies whether to filter out queries that have low relevance.
+          #
+          #     If this field is set to `false`, all search results are used regardless
+          #     of relevance to generate answers. If set to `true` or unset, the behavior
+          #     will be determined automatically by the service.
           class AnswerGenerationSpec
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -421,6 +428,12 @@ module Google
             #     [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
             #
             #     If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
+            # @!attribute [rw] data_store_specs
+            #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::DataStoreSpec>]
+            #     Specs defining dataStores to filter on in a search call and
+            #     configurations for those dataStores. This is only considered for
+            #     engines with multiple dataStores use case. For single dataStore within
+            #     an engine, they should use the specs at the top level.
             class SearchParams
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -561,7 +574,7 @@ module Google
             # @!attribute [rw] max_rephrase_steps
             #   @return [::Integer]
             #     Max rephrase steps.
-            #     The max number is 10 steps.
+            #     The max number is 5 steps.
             #     If not set or set to < 1, it will be set to 1 by default.
             class QueryRephraserSpec
               include ::Google::Protobuf::MessageExts
@@ -587,6 +600,9 @@ module Google
         #     It will be only available when session field is set and valid in the
         #     {::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryRequest AnswerQueryRequest}
         #     request.
+        # @!attribute [rw] answer_query_token
+        #   @return [::String]
+        #     A global unique ID used for logging.
         class AnswerQueryResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/discoveryengine/v1beta/custom_tuning_model.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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 V1beta
+        # Metadata that describes a custom tuned model.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The fully qualified resource name of the model.
+        #
+        #     Format:
+        #     `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`
+        #     model must be an alpha-numerical string with limit of 40 characters.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     The display name of the model.
+        # @!attribute [rw] model_version
+        #   @return [::Integer]
+        #     The version of the model.
+        # @!attribute [rw] model_state
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::CustomTuningModel::ModelState]
+        #     The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`).
+        # @!attribute [rw] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Timestamp the Model was created at.
+        # @!attribute [rw] training_start_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Timestamp the model training was initiated.
+        class CustomTuningModel
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The state of the model.
+          module ModelState
+            # Default value.
+            MODEL_STATE_UNSPECIFIED = 0
+
+            # The model is in a paused training state.
+            TRAINING_PAUSED = 1
+
+            # The model is currently training.
+            TRAINING = 2
+
+            # The model has successfully completed training.
+            TRAINING_COMPLETE = 3
+
+            # The model is ready for serving.
+            READY_FOR_SERVING = 4
+
+            # The model training failed.
+            TRAINING_FAILED = 5
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -124,8 +124,8 @@ module Google
         #     INVALID_ARGUMENT error is returned.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Filter by solution type. For example: filter =
-        #     'solution_type:SOLUTION_TYPE_SEARCH'
+        #     Filter by solution type .
+        #     For example: `filter = 'solution_type:SOLUTION_TYPE_SEARCH'`
         class ListDataStoresRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -42,6 +42,7 @@ module Google
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::DiscoveryEngine::V1beta::DocumentProcessingConfig::ParsingConfig}]
         #     Map from file type to override the default parsing configuration based on
         #     the file type. Supported keys:
+        #
         #     * `pdf`: Override parsing config for PDF files, either digital parsing, ocr
         #     parsing or layout parsing is supported.
         #     * `html`: Override parsing config for HTML files, only digital parsing and

data/proto_docs/google/cloud/discoveryengine/v1beta/document_service.rb

@@ -59,7 +59,7 @@ module Google
         #   @return [::Integer]
         #     Maximum number of {::Google::Cloud::DiscoveryEngine::V1beta::Document Document}s
         #     to return. If unspecified, defaults to 100. The maximum allowed value is
-        #     1000. Values above 1000 will be coerced to 1000.
+        #     1000. Values above 1000 are set to 1000.
         #
         #     If this field is negative, an `INVALID_ARGUMENT` error is returned.
         # @!attribute [rw] page_token
@@ -110,8 +110,8 @@ module Google
         # @!attribute [rw] document_id
         #   @return [::String]
         #     Required. The ID to use for the
-        #     {::Google::Cloud::DiscoveryEngine::V1beta::Document Document}, which will become
-        #     the final component of the
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Document Document}, which becomes the
+        #     final component of the
         #     {::Google::Cloud::DiscoveryEngine::V1beta::Document#name Document.name}.
         #
         #     If the caller does not have permission to create the
@@ -148,14 +148,13 @@ module Google
         #     is not set, a `NOT_FOUND` error is returned.
         # @!attribute [rw] allow_missing
         #   @return [::Boolean]
-        #     If set to true, and the
+        #     If set to `true` and the
         #     {::Google::Cloud::DiscoveryEngine::V1beta::Document Document} is not found, a
-        #     new {::Google::Cloud::DiscoveryEngine::V1beta::Document Document} will be
-        #     created.
+        #     new {::Google::Cloud::DiscoveryEngine::V1beta::Document Document} is be created.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     Indicates which fields in the provided imported 'document' to update. If
-        #     not set, will by default update all fields.
+        #     not set, by default updates all fields.
         class UpdateDocumentRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -94,7 +94,7 @@ module Google
         #     The restriction of the Engine industry vertical is based on
         #     {::Google::Cloud::DiscoveryEngine::V1beta::DataStore DataStore}: If unspecified,
         #     default to `GENERIC`. Vertical on Engine has to match vertical of the
-        #     DataStore liniked to the engine.
+        #     DataStore linked to the engine.
         # @!attribute [rw] common_config
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Engine::CommonConfig]
         #     Common config spec that specifies the metadata of the engine.
@@ -192,8 +192,8 @@ module Google
           # Common configurations for an Engine.
           # @!attribute [rw] company_name
           #   @return [::String]
-          #     Immutable. The name of the company, business or entity that is associated
-          #     with the engine. Setting this may help improve LLM related features.
+          #     The name of the company, business or entity that is associated with the
+          #     engine. Setting this may help improve LLM related features.
           class CommonConfig
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -43,7 +43,7 @@ module Google
         #     `projects/*/locations/global/groundingConfigs/default_grounding_config`.
         # @!attribute [rw] answer_candidate
         #   @return [::String]
-        #     Answer candidate to check.
+        #     Answer candidate to check. Can have a maximum length of 1024 characters.
         # @!attribute [rw] facts
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::GroundingFact>]
         #     List of facts for the grounding check.
@@ -51,9 +51,37 @@ module Google
         # @!attribute [rw] grounding_spec
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::CheckGroundingSpec]
         #     Configuration of the grounding check.
+        # @!attribute [rw] user_labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     The user labels applied to a resource must meet the following requirements:
+        #
+        #     * Each resource can have multiple labels, up to a maximum of 64.
+        #     * Each label must be a key-value pair.
+        #     * Keys have a minimum length of 1 character and a maximum length of 63
+        #       characters and cannot be empty. Values can be empty and have a maximum
+        #       length of 63 characters.
+        #     * Keys and values can contain only lowercase letters, numeric characters,
+        #       underscores, and dashes. All characters must use UTF-8 encoding, and
+        #       international characters are allowed.
+        #     * The key portion of a label must be unique. However, you can use the same
+        #       key with multiple resources.
+        #     * Keys must start with a lowercase letter or international character.
+        #
+        #     See [Google Cloud
+        #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+        #     for more details.
         class CheckGroundingRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class UserLabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # Response message for the
@@ -95,6 +123,16 @@ module Google
           #     cited_chunks[1], cited_chunks[3], cited_chunks[4] are the facts cited
           #     supporting for the claim. A citation to a fact indicates that the claim
           #     is supported by the fact.
+          # @!attribute [rw] grounding_check_required
+          #   @return [::Boolean]
+          #     Indicates that this claim required grounding check. When the system
+          #     decided this claim doesn't require attribution/grounding check, this
+          #     field will be set to false. In that case, no grounding check was done for
+          #     the claim and therefore
+          #     {::Google::Cloud::DiscoveryEngine::V1beta::CheckGroundingResponse::Claim#citation_indices citation_indices},
+          #     and
+          #     [anti_citation_indices][google.cloud.discoveryengine.v1beta.CheckGroundingResponse.Claim.anti_citation_indices]
+          #     should not be returned.
           class Claim
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -54,6 +54,9 @@ module Google
         #     from the GroundingFacts provided in the request then this field will
         #     contain the index of the specific fact from which this chunk was
         #     retrieved.
+        # @!attribute [rw] index
+        #   @return [::Integer]
+        #     The index of this chunk. Currently, only used for the streaming mode.
         # @!attribute [rw] source_metadata
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     More fine-grained information for the source reference.

data/proto_docs/google/cloud/discoveryengine/v1beta/import_config.rb

@@ -24,7 +24,7 @@ module Google
         # Cloud Storage location for input content.
         # @!attribute [rw] input_uris
         #   @return [::Array<::String>]
-        #     Required. Cloud Storage URIs to input files. URI can be up to
+        #     Required. Cloud Storage URIs to input files. Each URI can be up to
         #     2000 characters long. URIs can match the full object path (for example,
         #     `gs://bucket/directory/object.json`) or a pattern matching one or more
         #     files, such as `gs://bucket/directory/*.json`.
@@ -54,7 +54,7 @@ module Google
         #       data store. Each entry after the header is imported as a Document.
         #       This can only be used by the GENERIC Data Store vertical.
         #
-        #     Supported values for user even imports:
+        #     Supported values for user event imports:
         #
         #     * `user_event` (default): One JSON
         #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent UserEvent} per line.
@@ -351,8 +351,8 @@ module Google
         #     of 256 characters.
         # @!attribute [rw] collection_id
         #   @return [::String]
-        #     Required. The Firestore collection to copy the data from with a length
-        #     limit of 1,500 characters.
+        #     Required. The Firestore collection (or entity) to copy the data from with a
+        #     length limit of 1,500 characters.
         # @!attribute [rw] gcs_staging_dir
         #   @return [::String]
         #     Intermediate Cloud Storage directory used for the import with a length