google-cloud-discovery_engine-v1beta 0.14.2 → 0.16.0

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

@@ -50,7 +50,7 @@ module Google
         #     characters.
         #
         #     Format:
-        #     `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}`
+        #     `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`
         #     engine should be 1-63 characters, and valid characters are
         #     /[a-z0-9][a-z0-9-_]*/. Otherwise, an INVALID_ARGUMENT error is returned.
         # @!attribute [rw] display_name
@@ -98,6 +98,10 @@ module Google
         # @!attribute [rw] common_config
         #   @return [::Google::Cloud::DiscoveryEngine::V1beta::Engine::CommonConfig]
         #     Common config spec that specifies the metadata of the engine.
+        # @!attribute [rw] disable_analytics
+        #   @return [::Boolean]
+        #     Optional. Whether to disable analytics for searches performed on this
+        #     engine.
         class Engine
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -179,7 +179,7 @@ module Google
         #   @return [::String]
         #     Required. The name of the engine to pause.
         #     Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`
         class PauseEngineRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -190,7 +190,7 @@ module Google
         #   @return [::String]
         #     Required. The name of the engine to resume.
         #     Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`
         class ResumeEngineRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -202,7 +202,7 @@ module Google
         #   @return [::String]
         #     Required. The resource name of the engine to tune.
         #     Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`
         class TuneEngineRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -213,7 +213,7 @@ module Google
         #   @return [::String]
         #     Required. The resource name of the engine that this tune applies to.
         #     Format:
-        #     `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`
+        #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`
         class TuneEngineMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -21,6 +21,388 @@ module Google
   module Cloud
     module DiscoveryEngine
       module V1beta
+        # Base structured datatype containing multi-part content of a message.
+        # @!attribute [rw] role
+        #   @return [::String]
+        #     Producer of the content. Must be either `user` or `model`.
+        #
+        #     Intended to be used for multi-turn conversations. Otherwise, it can be left
+        #     unset.
+        # @!attribute [rw] parts
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::GroundedGenerationContent::Part>]
+        #     Ordered `Parts` that constitute a single message.
+        class GroundedGenerationContent
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Single part of content.
+          # @!attribute [rw] text
+          #   @return [::String]
+          #     Inline text.
+          class Part
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Top-level message sent by the client for the `GenerateGroundedContent`
+        # method.
+        # @!attribute [rw] location
+        #   @return [::String]
+        #     Required. Location resource.
+        #
+        #     Format: `projects/{project}/locations/{location}`.
+        # @!attribute [rw] system_instruction
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GroundedGenerationContent]
+        #     Content of the system instruction for the current API.
+        #
+        #     These instructions will take priority over any other prompt instructions
+        #     if the selected model is supporting them.
+        # @!attribute [rw] contents
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::GroundedGenerationContent>]
+        #     Content of the current conversation with the model.
+        #
+        #     For single-turn queries, this is a single instance. For multi-turn queries,
+        #     this is a repeated field that contains conversation history + latest
+        #     request.
+        # @!attribute [rw] generation_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentRequest::GenerationSpec]
+        #     Content generation specification.
+        # @!attribute [rw] grounding_spec
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentRequest::GroundingSpec]
+        #     Grounding specification.
+        # @!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 GenerateGroundedContentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Content generation specification.
+          # @!attribute [rw] model_id
+          #   @return [::String]
+          #     Specifies which Vertex model id to use for generation.
+          # @!attribute [rw] language_code
+          #   @return [::String]
+          #     Language code for content. Use language tags defined by
+          #     [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt).
+          # @!attribute [rw] temperature
+          #   @return [::Float]
+          #     If specified, custom value for the temperature will be used.
+          # @!attribute [rw] top_p
+          #   @return [::Float]
+          #     If specified, custom value for nucleus sampling will be used.
+          # @!attribute [rw] top_k
+          #   @return [::Integer]
+          #     If specified, custom value for top-k sampling will be used.
+          # @!attribute [rw] frequency_penalty
+          #   @return [::Float]
+          #     If specified, custom value for frequency penalty will be used.
+          # @!attribute [rw] presence_penalty
+          #   @return [::Float]
+          #     If specified, custom value for presence penalty will be used.
+          # @!attribute [rw] max_output_tokens
+          #   @return [::Integer]
+          #     If specified, custom value for max output tokens will be used.
+          class GenerationSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Describes the options to customize dynamic retrieval.
+          # @!attribute [rw] predictor
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentRequest::DynamicRetrievalConfiguration::DynamicRetrievalPredictor]
+          #     Specification for the predictor for dynamic retrieval.
+          class DynamicRetrievalConfiguration
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Describes the predictor settings for dynamic retrieval.
+            # @!attribute [rw] version
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentRequest::DynamicRetrievalConfiguration::DynamicRetrievalPredictor::Version]
+            #     The version of the predictor to be used in dynamic retrieval.
+            # @!attribute [rw] threshold
+            #   @return [::Float]
+            #     The value of the threshold. If the predictor will predict a
+            #     value smaller than this, it would suppress grounding in the source.
+            class DynamicRetrievalPredictor
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # The version of the predictor to be used in dynamic retrieval.
+              module Version
+                # Automatically choose the best version of the retrieval predictor.
+                VERSION_UNSPECIFIED = 0
+
+                # The V1 model which is evaluating each source independently.
+                V1_INDEPENDENT = 1
+              end
+            end
+          end
+
+          # Grounding source.
+          # @!attribute [rw] inline_source
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentRequest::GroundingSource::InlineSource]
+          #     If set, grounding is performed with inline content.
+          # @!attribute [rw] search_source
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentRequest::GroundingSource::SearchSource]
+          #     If set, grounding is performed with Vertex AI Search.
+          # @!attribute [rw] google_search_source
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentRequest::GroundingSource::GoogleSearchSource]
+          #     If set, grounding is performed with Google Search.
+          class GroundingSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Message to be used for grounding based on inline content.
+            # @!attribute [rw] grounding_facts
+            #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::GroundingFact>]
+            #     List of facts to be used for grounding.
+            # @!attribute [rw] attributes
+            #   @return [::Google::Protobuf::Map{::String => ::String}]
+            #     Attributes associated with the content.
+            #
+            #     Common attributes include `source` (indicating where the content was
+            #     sourced from) and `author` (indicating the author of the content).
+            class InlineSource
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # @!attribute [rw] key
+              #   @return [::String]
+              # @!attribute [rw] value
+              #   @return [::String]
+              class AttributesEntry
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+            end
+
+            # Message to be used for grounding with Vertex AI Search.
+            # @!attribute [rw] serving_config
+            #   @return [::String]
+            #     The resource name of the Engine to use.
+            #
+            #     Format:
+            #     `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}/servingConfigs/{serving_config_id}`
+            # @!attribute [rw] max_result_count
+            #   @return [::Integer]
+            #     Number of search results to return.
+            #
+            #     The default value is 10. The maximumm allowed value is 10.
+            # @!attribute [rw] filter
+            #   @return [::String]
+            #     Filter expression to be applied to the search.
+            #
+            #     The syntax is the same as
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest#filter SearchRequest.filter}.
+            # @!attribute [rw] safe_search
+            #   @return [::Boolean]
+            #     If set, safe search is enabled in Vertex AI Search requests.
+            class SearchSource
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Google Search config parameters.
+            # @!attribute [rw] dynamic_retrieval_config
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentRequest::DynamicRetrievalConfiguration]
+            #     Optional. Specifies the dynamic retrieval configuration for the given
+            #     source.
+            class GoogleSearchSource
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Grounding specification.
+          # @!attribute [rw] grounding_sources
+          #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentRequest::GroundingSource>]
+          #     Grounding sources.
+          class GroundingSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class UserLabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Response for the `GenerateGroundedContent` method.
+        # @!attribute [rw] candidates
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentResponse::Candidate>]
+        #     Generated candidates.
+        class GenerateGroundedContentResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # A response candidate generated from the model.
+          # @!attribute [rw] index
+          #   @return [::Integer]
+          #     Index of the candidate.
+          # @!attribute [rw] content
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GroundedGenerationContent]
+          #     Content of the candidate.
+          # @!attribute [rw] grounding_score
+          #   @return [::Float]
+          #     The overall grounding score for the candidate, in the range of [0, 1].
+          # @!attribute [rw] grounding_metadata
+          #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentResponse::Candidate::GroundingMetadata]
+          #     Grounding metadata for the generated content.
+          class Candidate
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Citation for the generated content.
+            # @!attribute [rw] retrieval_metadata
+            #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentResponse::Candidate::GroundingMetadata::RetrievalMetadata>]
+            #     Retrieval metadata to provide an understanding in the
+            #     retrieval steps performed by the model. There can be multiple such
+            #     messages which can correspond to different parts of the retrieval. This
+            #     is a mechanism used to ensure transparency to our users.
+            # @!attribute [rw] support_chunks
+            #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::FactChunk>]
+            #     List of chunks to be attributed across all claims in the candidate.
+            #     These are derived from the grounding sources supplied in the request.
+            # @!attribute [rw] web_search_queries
+            #   @return [::Array<::String>]
+            #     Web search queries for the following-up web search.
+            # @!attribute [rw] search_entry_point
+            #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentResponse::Candidate::GroundingMetadata::SearchEntryPoint]
+            #     Google search entry for the following-up web searches.
+            # @!attribute [rw] grounding_support
+            #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentResponse::Candidate::GroundingMetadata::GroundingSupport>]
+            #     GroundingSupport across all claims in the answer candidate.
+            #     An support to a fact indicates that the claim is supported by
+            #     the fact.
+            class GroundingMetadata
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Describes the metadata associated with a retrieval step.
+              # @!attribute [rw] source
+              #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentResponse::Candidate::GroundingMetadata::RetrievalMetadata::Source]
+              #     Describes the source to which the metadata is referring to.
+              # @!attribute [rw] dynamic_retrieval_metadata
+              #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentResponse::Candidate::GroundingMetadata::DynamicRetrievalMetadata]
+              #     Metadata for dynamic retrieval.
+              class RetrievalMetadata
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+
+                # Describes the source to which the metadata is associated to.
+                module Source
+                  # Unspecified source.
+                  SOURCE_UNSPECIFIED = 0
+
+                  # Vertex AI search.
+                  VERTEX_AI_SEARCH = 1
+
+                  # Google Search.
+                  GOOGLE_SEARCH = 3
+
+                  # User inline provided content.
+                  INLINE_CONTENT = 2
+
+                  # Google Maps.
+                  GOOGLE_MAPS = 4
+                end
+              end
+
+              # Describes the metadata about dynamic retrieval.
+              # @!attribute [rw] predictor_metadata
+              #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentResponse::Candidate::GroundingMetadata::DynamicRetrievalPredictorMetadata]
+              #     Metadata for the dynamic retrieval predictor.
+              class DynamicRetrievalMetadata
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+
+              # Describes the metadata about the dynamic retrieval predictor.
+              # @!attribute [rw] version
+              #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GenerateGroundedContentResponse::Candidate::GroundingMetadata::DynamicRetrievalPredictorMetadata::Version]
+              #     The version of the predictor which was used in dynamic retrieval.
+              # @!attribute [rw] prediction
+              #   @return [::Float]
+              #     The value of the predictor. This should be between [0, 1] where
+              #     a value of 0 means that the query would not benefit from grounding,
+              #     while a value of 1.0 means that the query would benefit the most.
+              #     In between values allow to differentiate between different usefulness
+              #     scores for grounding.
+              class DynamicRetrievalPredictorMetadata
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+
+                # The version of the predictor which was used in dynamic retrieval.
+                module Version
+                  # Unspecified version, should never be used.
+                  VERSION_UNSPECIFIED = 0
+
+                  # The V1 model which is evaluating each source independently.
+                  V1_INDEPENDENT = 1
+                end
+              end
+
+              # Google search entry point.
+              # @!attribute [rw] rendered_content
+              #   @return [::String]
+              #     Web content snippet that can be embedded in a web page or an app
+              #     webview.
+              # @!attribute [rw] sdk_blob
+              #   @return [::String]
+              #     Base64 encoded JSON representing array of <search term, search url>
+              #     tuple.
+              class SearchEntryPoint
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+
+              # Grounding info for a claim in the candidate and its support.
+              # @!attribute [rw] claim_text
+              #   @return [::String]
+              #     Text for the claim in the candidate. Always provided when a
+              #     support is found.
+              # @!attribute [rw] support_chunk_indices
+              #   @return [::Array<::Integer>]
+              #     A list of indices (into 'support_chunks') specifying the
+              #     citations associated with the claim. For instance [1,3,4] means
+              #     that support_chunks[1], support_chunks[3],
+              #     support_chunks[4] are the chunks attributed to the claim.
+              # @!attribute [rw] support_score
+              #   @return [::Float]
+              #     A score in the range of [0, 1] describing how grounded is a specific
+              #     claim in the support chunks indicated.
+              #     Higher value means that the claim is better supported by the chunks.
+              class GroundingSupport
+                include ::Google::Protobuf::MessageExts
+                extend ::Google::Protobuf::MessageExts::ClassMethods
+              end
+            end
+          end
+        end
+
         # Specification for the grounding check.
         # @!attribute [rw] citation_threshold
         #   @return [::Float]
@@ -43,7 +425,7 @@ module Google
         #     `projects/*/locations/global/groundingConfigs/default_grounding_config`.
         # @!attribute [rw] answer_candidate
         #   @return [::String]
-        #     Answer candidate to check. Can have a maximum length of 1024 characters.
+        #     Answer candidate to check. It can have a maximum length of 4096 tokens.
         # @!attribute [rw] facts
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::GroundingFact>]
         #     List of facts for the grounding check.
@@ -96,6 +478,10 @@ module Google
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::FactChunk>]
         #     List of facts cited across all claims in the answer candidate.
         #     These are derived from the facts supplied in the request.
+        # @!attribute [rw] cited_facts
+        #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::CheckGroundingResponse::CheckGroundingFactChunk>]
+        #     List of facts cited across all claims in the answer candidate.
+        #     These are derived from the facts supplied in the request.
         # @!attribute [rw] claims
         #   @return [::Array<::Google::Cloud::DiscoveryEngine::V1beta::CheckGroundingResponse::Claim>]
         #     Claim texts and citation info across all claims in the answer candidate.
@@ -103,6 +489,15 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Fact chunk for grounding check.
+          # @!attribute [rw] chunk_text
+          #   @return [::String]
+          #     Text content of the fact chunk. Can be at most 10K characters long.
+          class CheckGroundingFactChunk
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Text and citation info for a claim in the answer candidate.
           # @!attribute [rw] start_pos
           #   @return [::Integer]
@@ -130,8 +525,9 @@ module Google
           #     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},
+          #     [anti_citation_indices][google.cloud.discoveryengine.v1beta.CheckGroundingResponse.Claim.anti_citation_indices],
           #     and
-          #     [anti_citation_indices][google.cloud.discoveryengine.v1beta.CheckGroundingResponse.Claim.anti_citation_indices]
+          #     [score][google.cloud.discoveryengine.v1beta.CheckGroundingResponse.Claim.score]
           #     should not be returned.
           class Claim
             include ::Google::Protobuf::MessageExts

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

@@ -21,6 +21,16 @@ module Google
   module Cloud
     module DiscoveryEngine
       module V1beta
+        # Grounding configuration.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the GroundingConfig, of the form
+        #     `projects/{project}/locations/{location}/groundingConfigs/{grounding_config}`.
+        class GroundingConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Grounding Fact.
         # @!attribute [rw] fact_text
         #   @return [::String]

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

@@ -69,7 +69,7 @@ module Google
         #     BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
         # @!attribute [rw] project_id
         #   @return [::String]
-        #     The project ID (can be project # or ID) that the BigQuery source is in with
+        #     The project ID or the project number that contains the BigQuery source. Has
         #     a length limit of 128 characters. If not specified, inherits the project
         #     ID from the parent request.
         # @!attribute [rw] dataset_id
@@ -114,7 +114,7 @@ module Google
         # The Spanner source for importing data
         # @!attribute [rw] project_id
         #   @return [::String]
-        #     The project ID that the Spanner source is in with a length limit of 128
+        #     The project ID that contains the Spanner source. Has a length limit of 128
         #     characters. If not specified, inherits the project ID from the parent
         #     request.
         # @!attribute [rw] instance_id
@@ -269,7 +269,7 @@ module Google
         # The Cloud Bigtable source for importing data.
         # @!attribute [rw] project_id
         #   @return [::String]
-        #     The project ID that the Bigtable source is in with a length limit of 128
+        #     The project ID that contains the Bigtable source. Has a length limit of 128
         #     characters. If not specified, inherits the project ID from the parent
         #     request.
         # @!attribute [rw] instance_id
@@ -298,6 +298,12 @@ module Google
         #     Intermediate Cloud Storage directory used for the import with a length
         #     limit of 2,000 characters. Can be specified if one wants to have the
         #     FhirStore export to a specific Cloud Storage directory.
+        # @!attribute [rw] resource_types
+        #   @return [::Array<::String>]
+        #     The FHIR resource types to import. The resource types should be a subset of
+        #     all [supported FHIR resource
+        #     types](https://cloud.google.com/generative-ai-app-builder/docs/fhir-schema-reference#resource-level-specification).
+        #     Default to all supported FHIR resource types if empty.
         class FhirStoreSource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -306,8 +312,8 @@ module Google
         # Cloud SQL source import data from.
         # @!attribute [rw] project_id
         #   @return [::String]
-        #     The project ID that the Cloud SQL source is in with a length limit of 128
-        #     characters. If not specified, inherits the project ID from the parent
+        #     The project ID that contains the Cloud SQL source. Has a length limit of
+        #     128 characters. If not specified, inherits the project ID from the parent
         #     request.
         # @!attribute [rw] instance_id
         #   @return [::String]
@@ -342,8 +348,8 @@ module Google
         # AlloyDB source import data from.
         # @!attribute [rw] project_id
         #   @return [::String]
-        #     The project ID that the AlloyDB source is in
-        #     with a length limit of 128 characters. If not specified, inherits the
+        #     The project ID that contains the AlloyDB source.
+        #     Has a length limit of 128 characters. If not specified, inherits the
         #     project ID from the parent request.
         # @!attribute [rw] location_id
         #   @return [::String]

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

@@ -25,7 +25,7 @@ module Google
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. Full resource name of the project, for example
-        #     `projects/{project_number}`.
+        #     `projects/{project}`.
         #     Note that when making requests, project number and project id are both
         #     acceptable, but the server will always respond in project number.
         # @!attribute [r] create_time

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

@@ -26,7 +26,7 @@ module Google
         #   @return [::String]
         #     Required. The resource name of the catalog under which the events are
         #     created. The format is
-        #     `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}`
+        #     `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`.
         # @!attribute [rw] filter
         #   @return [::String]
         #     Required. The filter string to specify the events to be deleted with a
@@ -98,9 +98,30 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Configuration of destination for Purge related errors.
+        # @!attribute [rw] gcs_prefix
+        #   @return [::String]
+        #     Cloud Storage prefix for purge errors. This must be an empty,
+        #     existing Cloud Storage directory. Purge errors are written to
+        #     sharded files in this directory, one per line, as a JSON-encoded
+        #     `google.rpc.Status` message.
+        class PurgeErrorConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for
         # {::Google::Cloud::DiscoveryEngine::V1beta::DocumentService::Client#purge_documents DocumentService.PurgeDocuments}
         # method.
+        # @!attribute [rw] gcs_source
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::GcsSource]
+        #     Cloud Storage location for the input content.
+        #     Supported `data_schema`:
+        #     * `document_id`: One valid
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Document#id Document.id} per line.
+        # @!attribute [rw] inline_source
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::PurgeDocumentsRequest::InlineSource]
+        #     Inline source for the input content for purge.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The parent resource name, such as
@@ -110,6 +131,9 @@ module Google
         #     Required. Filter matching documents to purge. Only currently supported
         #     value is
         #     `*` (all items).
+        # @!attribute [rw] error_config
+        #   @return [::Google::Cloud::DiscoveryEngine::V1beta::PurgeErrorConfig]
+        #     The desired location of errors incurred during the purge.
         # @!attribute [rw] force
         #   @return [::Boolean]
         #     Actually performs the purge. If `force` is set to false, return the
@@ -117,6 +141,20 @@ module Google
         class PurgeDocumentsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The inline source for the input config for
+          # {::Google::Cloud::DiscoveryEngine::V1beta::DocumentService::Client#purge_documents DocumentService.PurgeDocuments}
+          # method.
+          # @!attribute [rw] documents
+          #   @return [::Array<::String>]
+          #     Required. A list of full resource name of documents to purge. In the
+          #     format
+          #     `projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*`.
+          #     Recommended max of 100 items.
+          class InlineSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # Response message for

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

@@ -55,7 +55,7 @@ module Google
         # @!attribute [rw] ranking_config
         #   @return [::String]
         #     Required. The resource name of the rank service config, such as
-        #     `projects/{project_num}/locations/{location_id}/rankingConfigs/default_ranking_config`.
+        #     `projects/{project_num}/locations/{location}/rankingConfigs/default_ranking_config`.
         # @!attribute [rw] model
         #   @return [::String]
         #     The identifier of the model to use. It is one of: