google-api-python-client 2.175.0__py3-none-any.whl → 2.177.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/discoveryengine.v1.json

@@ -4,6 +4,9 @@
 "scopes": {
 "https://www.googleapis.com/auth/cloud-platform": {
 "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account."
+},
+"https://www.googleapis.com/auth/cloud_search.query": {
+"description": "Search your organization's data in the Cloud Search index"
 }
 }
 }
@@ -35,6 +38,11 @@
 "description": "Regional Endpoint",
 "endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/",
 "location": "eu"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.in.rep.googleapis.com/",
+"location": "in"
 }
 ],
 "fullyEncodeReservedExpansion": true,
@@ -1048,6 +1056,39 @@
 }
 }
 },
+"completionConfig": {
+"methods": {
+"completeQuery": {
+"description": "Completes the user input with advanced keyword suggestions.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}/completionConfig:completeQuery",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.dataStores.completionConfig.completeQuery",
+"parameterOrder": [
+"completionConfig"
+],
+"parameters": {
+"completionConfig": {
+"description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/completionConfig$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+completionConfig}:completeQuery",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloud_search.query"
+]
+}
+}
+},
 "completionSuggestions": {
 "methods": {
 "import": {
@@ -2134,7 +2175,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
+"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
 "location": "query",
 "type": "string"
 },
@@ -3153,6 +3194,71 @@
 }
 },
 "resources": {
+"assistants": {
+"methods": {
+"streamAssist": {
+"description": "Assists the user with a query in a streaming fashion.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}:streamAssist",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.engines.assistants.streamAssist",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:streamAssist",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1StreamAssistRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1StreamAssistResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
+"completionConfig": {
+"methods": {
+"completeQuery": {
+"description": "Completes the user input with advanced keyword suggestions.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/completionConfig:completeQuery",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.collections.engines.completionConfig.completeQuery",
+"parameterOrder": [
+"completionConfig"
+],
+"parameters": {
+"completionConfig": {
+"description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/completionConfig$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+completionConfig}:completeQuery",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloud_search.query"
+]
+}
+}
+},
 "controls": {
 "methods": {
 "create": {
@@ -3876,7 +3982,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
+"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
 "location": "query",
 "type": "string"
 },
@@ -4664,6 +4770,39 @@
 }
 }
 },
+"completionConfig": {
+"methods": {
+"completeQuery": {
+"description": "Completes the user input with advanced keyword suggestions.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}/completionConfig:completeQuery",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.dataStores.completionConfig.completeQuery",
+"parameterOrder": [
+"completionConfig"
+],
+"parameters": {
+"completionConfig": {
+"description": "Required. The completion_config of the parent dataStore or engine resource name for which the completion is performed, such as `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig` `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/completionConfig$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+completionConfig}:completeQuery",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloud_search.query"
+]
+}
+}
+},
 "completionSuggestions": {
 "methods": {
 "import": {
@@ -5649,7 +5788,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
+"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
 "location": "query",
 "type": "string"
 },
@@ -7052,7 +7191,7 @@
 }
 }
 },
-"revision": "20250619",
+"revision": "20250716",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -7468,6 +7607,318 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest": {
+"description": "Request message for CompletionService.AdvancedCompleteQuery method. .",
+"id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequest",
+"properties": {
+"boostSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequestBoostSpec",
+"description": "Optional. Specification to boost suggestions matching the condition."
+},
+"experimentIds": {
+"description": "Optional. Experiment ids for this request.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"includeTailSuggestions": {
+"description": "Indicates if tail suggestions should be returned if there are no suggestions that match the full query. Even if set to true, if there are suggestions that match the full query, those are returned and no tail suggestions are returned.",
+"type": "boolean"
+},
+"query": {
+"description": "Required. The typeahead input used to fetch suggestions. Maximum length is 128 characters. The query can not be empty for most of the suggestion types. If it is empty, an `INVALID_ARGUMENT` error is returned. The exception is when the suggestion_types contains only the type `RECENT_SEARCH`, the query can be an empty string. The is called \"zero prefix\" feature, which returns user's recently searched queries given the empty query.",
+"type": "string"
+},
+"queryModel": {
+"description": "Specifies the autocomplete query model, which only applies to the QUERY SuggestionType. This overrides any model specified in the Configuration > Autocomplete section of the Cloud console. Currently supported values: * `document` - Using suggestions generated from user-imported documents. * `search-history` - Using suggestions generated from the past history of SearchService.Search API calls. Do not use it when there is no traffic for Search API. * `user-event` - Using suggestions generated from user-imported search events. * `document-completable` - Using suggestions taken directly from user-imported document fields marked as completable. Default values: * `document` is the default model for regular dataStores. * `search-history` is the default model for site search dataStores.",
+"type": "string"
+},
+"suggestionTypeSpecs": {
+"description": "Optional. Specification of each suggestion type.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequestSuggestionTypeSpec"
+},
+"type": "array"
+},
+"suggestionTypes": {
+"description": "Optional. Suggestion types to return. If empty or unspecified, query suggestions are returned. Only one suggestion type is supported at the moment.",
+"items": {
+"enum": [
+"SUGGESTION_TYPE_UNSPECIFIED",
+"QUERY",
+"PEOPLE",
+"CONTENT",
+"RECENT_SEARCH",
+"GOOGLE_WORKSPACE"
+],
+"enumDescriptions": [
+"Default value.",
+"Returns query suggestions.",
+"Returns people suggestions.",
+"Returns content suggestions.",
+"Returns recent search suggestions.",
+"Returns Google Workspace suggestions."
+],
+"type": "string"
+},
+"type": "array"
+},
+"userInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1UserInfo",
+"description": "Optional. Information about the end user. This should be the same identifier information as UserEvent.user_info and SearchRequest.user_info."
+},
+"userPseudoId": {
+"description": "A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. This field should NOT have a fixed value such as `unknown_visitor`. This should be the same identifier as UserEvent.user_pseudo_id and SearchRequest.user_pseudo_id. The field must be a UTF-8 encoded string with a length limit of 128",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequestBoostSpec": {
+"description": "Specification to boost suggestions based on the condtion of the suggestion.",
+"id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequestBoostSpec",
+"properties": {
+"conditionBoostSpecs": {
+"description": "Condition boost specifications. If a suggestion matches multiple conditions in the specifications, boost values from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20. Note: Currently only support language condition boost.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequestBoostSpecConditionBoostSpec"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequestBoostSpecConditionBoostSpec": {
+"description": "Boost applies to suggestions which match a condition.",
+"id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequestBoostSpecConditionBoostSpec",
+"properties": {
+"boost": {
+"description": "Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be a boosted suggestion. Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that are relevant might still be shown. Setting to 0.0 means no boost applied. The boosting condition is ignored.",
+"format": "float",
+"type": "number"
+},
+"condition": {
+"description": "An expression which specifies a boost condition. The syntax is the same as [filter expression syntax](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata#filter-expression-syntax). Currently, the only supported condition is a list of BCP-47 lang codes. Example: * To boost suggestions in languages `en` or `fr`: `(lang_code: ANY(\"en\", \"fr\"))`",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequestSuggestionTypeSpec": {
+"description": "Specification of each suggestion type.",
+"id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryRequestSuggestionTypeSpec",
+"properties": {
+"maxSuggestions": {
+"description": "Optional. Maximum number of suggestions to return for each suggestion type.",
+"format": "int32",
+"type": "integer"
+},
+"suggestionType": {
+"description": "Optional. Suggestion type.",
+"enum": [
+"SUGGESTION_TYPE_UNSPECIFIED",
+"QUERY",
+"PEOPLE",
+"CONTENT",
+"RECENT_SEARCH",
+"GOOGLE_WORKSPACE"
+],
+"enumDescriptions": [
+"Default value.",
+"Returns query suggestions.",
+"Returns people suggestions.",
+"Returns content suggestions.",
+"Returns recent search suggestions.",
+"Returns Google Workspace suggestions."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse": {
+"description": "Response message for CompletionService.AdvancedCompleteQuery method.",
+"id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponse",
+"properties": {
+"contentSuggestions": {
+"description": "Results of the matched content suggestions. The result list is ordered and the first result is the top suggestion.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponseContentSuggestion"
+},
+"type": "array"
+},
+"peopleSuggestions": {
+"description": "Results of the matched people suggestions. The result list is ordered and the first result is the top suggestion.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponsePersonSuggestion"
+},
+"type": "array"
+},
+"querySuggestions": {
+"description": "Results of the matched query suggestions. The result list is ordered and the first result is a top suggestion.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponseQuerySuggestion"
+},
+"type": "array"
+},
+"recentSearchSuggestions": {
+"description": "Results of the matched \"recent search\" suggestions. The result list is ordered and the first result is the top suggestion.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponseRecentSearchSuggestion"
+},
+"type": "array"
+},
+"tailMatchTriggered": {
+"description": "True if the returned suggestions are all tail suggestions. For tail matching to be triggered, include_tail_suggestions in the request must be true and there must be no suggestions that match the full query.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponseContentSuggestion": {
+"description": "Suggestions as content.",
+"id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponseContentSuggestion",
+"properties": {
+"contentType": {
+"description": "The type of the content suggestion.",
+"enum": [
+"CONTENT_TYPE_UNSPECIFIED",
+"GOOGLE_WORKSPACE",
+"THIRD_PARTY"
+],
+"enumDescriptions": [
+"Default value.",
+"The suggestion is from a Google Workspace source.",
+"The suggestion is from a third party source."
+],
+"type": "string"
+},
+"dataStore": {
+"description": "The name of the dataStore that this suggestion belongs to.",
+"type": "string"
+},
+"destinationUri": {
+"description": "The destination uri of the content suggestion.",
+"type": "string"
+},
+"document": {
+"$ref": "GoogleCloudDiscoveryengineV1Document",
+"description": "The document data snippet in the suggestion. Only a subset of fields will be populated."
+},
+"iconUri": {
+"description": "The icon uri of the content suggestion.",
+"type": "string"
+},
+"score": {
+"description": "The score of each suggestion. The score is in the range of [0, 1].",
+"format": "double",
+"type": "number"
+},
+"suggestion": {
+"description": "The suggestion for the query.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponsePersonSuggestion": {
+"description": "Suggestions as people.",
+"id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponsePersonSuggestion",
+"properties": {
+"dataStore": {
+"description": "The name of the dataStore that this suggestion belongs to.",
+"type": "string"
+},
+"destinationUri": {
+"description": "The destination uri of the person suggestion.",
+"type": "string"
+},
+"displayPhotoUri": {
+"description": "The photo uri of the person suggestion.",
+"type": "string"
+},
+"document": {
+"$ref": "GoogleCloudDiscoveryengineV1Document",
+"description": "The document data snippet in the suggestion. Only a subset of fields is populated."
+},
+"personType": {
+"description": "The type of the person.",
+"enum": [
+"PERSON_TYPE_UNSPECIFIED",
+"CLOUD_IDENTITY",
+"THIRD_PARTY_IDENTITY"
+],
+"enumDescriptions": [
+"Default value.",
+"The suggestion is from a GOOGLE_IDENTITY source.",
+"The suggestion is from a THIRD_PARTY_IDENTITY source."
+],
+"type": "string"
+},
+"score": {
+"description": "The score of each suggestion. The score is in the range of [0, 1].",
+"format": "double",
+"type": "number"
+},
+"suggestion": {
+"description": "The suggestion for the query.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponseQuerySuggestion": {
+"description": "Suggestions as search queries.",
+"id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponseQuerySuggestion",
+"properties": {
+"completableFieldPaths": {
+"description": "The unique document field paths that serve as the source of this suggestion if it was generated from completable fields. This field is only populated for the document-completable model.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"dataStore": {
+"description": "The name of the dataStore that this suggestion belongs to.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"score": {
+"description": "The score of each suggestion. The score is in the range of [0, 1].",
+"format": "double",
+"type": "number"
+},
+"suggestion": {
+"description": "The suggestion for the query.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponseRecentSearchSuggestion": {
+"description": "Suggestions from recent search history.",
+"id": "GoogleCloudDiscoveryengineV1AdvancedCompleteQueryResponseRecentSearchSuggestion",
+"properties": {
+"recentSearchTime": {
+"description": "The time when this recent rearch happened.",
+"format": "google-datetime",
+"type": "string"
+},
+"score": {
+"description": "The score of each suggestion. The score is in the range of [0, 1].",
+"format": "double",
+"type": "number"
+},
+"suggestion": {
+"description": "The suggestion for the query.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig": {
 "description": "Configuration data for advance site search.",
 "id": "GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig",
@@ -8559,154 +9010,445 @@
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1AnswerStep": {
-"description": "Step information.",
-"id": "GoogleCloudDiscoveryengineV1AnswerStep",
+"GoogleCloudDiscoveryengineV1AnswerStep": {
+"description": "Step information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStep",
+"properties": {
+"actions": {
+"description": "Actions.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepAction"
+},
+"type": "array"
+},
+"description": {
+"description": "The description of the step.",
+"type": "string"
+},
+"state": {
+"description": "The state of the step.",
+"enum": [
+"STATE_UNSPECIFIED",
+"IN_PROGRESS",
+"FAILED",
+"SUCCEEDED"
+],
+"enumDescriptions": [
+"Unknown.",
+"Step is currently in progress.",
+"Step currently failed.",
+"Step has succeeded."
+],
+"type": "string"
+},
+"thought": {
+"description": "The thought of the step.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStepAction": {
+"description": "Action.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepAction",
+"properties": {
+"observation": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservation",
+"description": "Observation."
+},
+"searchAction": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionSearchAction",
+"description": "Search action."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStepActionObservation": {
+"description": "Observation.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservation",
+"properties": {
+"searchResults": {
+"description": "Search results observed by the search action, it can be snippets info or chunk info, depending on the citation type set by the user.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResult"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResult": {
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResult",
+"properties": {
+"chunkInfo": {
+"description": "If citation_type is CHUNK_LEVEL_CITATION and chunk mode is on, populate chunk info.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultChunkInfo"
+},
+"type": "array"
+},
+"document": {
+"description": "Document resource name.",
+"type": "string"
+},
+"snippetInfo": {
+"description": "If citation_type is DOCUMENT_LEVEL_CITATION, populate document level snippets.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultSnippetInfo"
+},
+"type": "array"
+},
+"structData": {
+"additionalProperties": {
+"description": "Properties of the object.",
+"type": "any"
+},
+"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result.",
+"type": "object"
+},
+"title": {
+"description": "Title.",
+"type": "string"
+},
+"uri": {
+"description": "URI for the document.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultChunkInfo": {
+"description": "Chunk information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultChunkInfo",
+"properties": {
+"chunk": {
+"description": "Chunk resource name.",
+"type": "string"
+},
+"content": {
+"description": "Chunk textual content.",
+"type": "string"
+},
+"relevanceScore": {
+"description": "The relevance of the chunk for a given query. Values range from 0.0 (completely irrelevant) to 1.0 (completely relevant). This value is for informational purpose only. It may change for the same query and chunk at any time due to a model retraining or change in implementation.",
+"format": "float",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultSnippetInfo": {
+"description": "Snippet information.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultSnippetInfo",
+"properties": {
+"snippet": {
+"description": "Snippet content.",
+"type": "string"
+},
+"snippetStatus": {
+"description": "Status of the snippet defined by the search team.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerStepActionSearchAction": {
+"description": "Search action.",
+"id": "GoogleCloudDiscoveryengineV1AnswerStepActionSearchAction",
+"properties": {
+"query": {
+"description": "The query to search.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AssistAnswer": {
+"description": "AssistAnswer resource, main part of AssistResponse.",
+"id": "GoogleCloudDiscoveryengineV1AssistAnswer",
+"properties": {
+"assistSkippedReasons": {
+"description": "Reasons for not answering the assist call.",
+"items": {
+"enum": [
+"ASSIST_SKIPPED_REASON_UNSPECIFIED",
+"NON_ASSIST_SEEKING_QUERY_IGNORED",
+"CUSTOMER_POLICY_VIOLATION"
+],
+"enumDescriptions": [
+"Default value. Skip reason is not specified.",
+"The assistant ignored the query, because it did not appear to be answer-seeking.",
+"The assistant ignored the query or refused to answer because of a customer policy violation (e.g., the query or the answer contained a banned phrase)."
+],
+"type": "string"
+},
+"type": "array"
+},
+"replies": {
+"description": "Replies of the assistant.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistAnswerReply"
+},
+"type": "array"
+},
+"state": {
+"description": "State of the answer generation.",
+"enum": [
+"STATE_UNSPECIFIED",
+"IN_PROGRESS",
+"FAILED",
+"SUCCEEDED",
+"SKIPPED"
+],
+"enumDescriptions": [
+"Unknown.",
+"Assist operation is currently in progress.",
+"Assist operation has failed.",
+"Assist operation has succeeded.",
+"Assist operation has been skipped."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AssistAnswerReply": {
+"description": "One part of the multi-part response of the assist call.",
+"id": "GoogleCloudDiscoveryengineV1AssistAnswerReply",
+"properties": {
+"groundedContent": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistantGroundedContent",
+"description": "Possibly grounded response text or media from the assistant."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AssistUserMetadata": {
+"description": "User metadata of the request.",
+"id": "GoogleCloudDiscoveryengineV1AssistUserMetadata",
+"properties": {
+"preferredLanguageCode": {
+"description": "Optional. Preferred language to be used for answering if language detection fails. Also used as the language of error messages created by actions, regardless of language detection results.",
+"type": "string"
+},
+"timeZone": {
+"description": "Optional. IANA time zone, e.g. Europe/Budapest.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AssistantContent": {
+"description": "Multi-modal content.",
+"id": "GoogleCloudDiscoveryengineV1AssistantContent",
+"properties": {
+"codeExecutionResult": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistantContentCodeExecutionResult",
+"description": "Result of executing an ExecutableCode."
+},
+"executableCode": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistantContentExecutableCode",
+"description": "Code generated by the model that is meant to be executed."
+},
+"file": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistantContentFile",
+"description": "A file, e.g., an audio summary."
+},
+"inlineData": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistantContentBlob",
+"description": "Inline binary data."
+},
+"role": {
+"description": "The producer of the content. Can be \"model\" or \"user\".",
+"type": "string"
+},
+"text": {
+"description": "Inline text.",
+"type": "string"
+},
+"thought": {
+"description": "Optional. Indicates if the part is thought from the model.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AssistantContentBlob": {
+"description": "Inline blob.",
+"id": "GoogleCloudDiscoveryengineV1AssistantContentBlob",
 "properties": {
-"actions": {
-"description": "Actions.",
-"items": {
-"$ref": "GoogleCloudDiscoveryengineV1AnswerStepAction"
-},
-"type": "array"
+"data": {
+"description": "Required. Raw bytes.",
+"format": "byte",
+"type": "string"
 },
-"description": {
-"description": "The description of the step.",
+"mimeType": {
+"description": "Required. The media type (MIME type) of the generated data.",
 "type": "string"
+}
 },
-"state": {
-"description": "The state of the step.",
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AssistantContentCodeExecutionResult": {
+"description": "Result of executing ExecutableCode.",
+"id": "GoogleCloudDiscoveryengineV1AssistantContentCodeExecutionResult",
+"properties": {
+"outcome": {
+"description": "Required. Outcome of the code execution.",
 "enum": [
-"STATE_UNSPECIFIED",
-"IN_PROGRESS",
-"FAILED",
-"SUCCEEDED"
+"OUTCOME_UNSPECIFIED",
+"OUTCOME_OK",
+"OUTCOME_FAILED",
+"OUTCOME_DEADLINE_EXCEEDED"
 ],
 "enumDescriptions": [
-"Unknown.",
-"Step is currently in progress.",
-"Step currently failed.",
-"Step has succeeded."
+"Unspecified status. This value should not be used.",
+"Code execution completed successfully.",
+"Code execution finished but with a failure. `stderr` should contain the reason.",
+"Code execution ran for too long, and was cancelled. There may or may not be a partial output present."
 ],
 "type": "string"
 },
-"thought": {
-"description": "The thought of the step.",
+"output": {
+"description": "Optional. Contains stdout when code execution is successful, stderr or other description otherwise.",
 "type": "string"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1AnswerStepAction": {
-"description": "Action.",
-"id": "GoogleCloudDiscoveryengineV1AnswerStepAction",
+"GoogleCloudDiscoveryengineV1AssistantContentExecutableCode": {
+"description": "Code generated by the model that is meant to be executed by the model.",
+"id": "GoogleCloudDiscoveryengineV1AssistantContentExecutableCode",
 "properties": {
-"observation": {
-"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservation",
-"description": "Observation."
+"code": {
+"description": "Required. The code content. Currently only supports Python.",
+"type": "string"
+}
 },
-"searchAction": {
-"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionSearchAction",
-"description": "Search action."
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AssistantContentFile": {
+"description": "A file, e.g., an audio summary.",
+"id": "GoogleCloudDiscoveryengineV1AssistantContentFile",
+"properties": {
+"fileId": {
+"description": "Required. The file ID.",
+"type": "string"
+},
+"mimeType": {
+"description": "Required. The media type (MIME type) of the file.",
+"type": "string"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1AnswerStepActionObservation": {
-"description": "Observation.",
-"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservation",
+"GoogleCloudDiscoveryengineV1AssistantGroundedContent": {
+"description": "A piece of content and possibly its grounding information. Not all content needs grounding. Phrases like \"Of course, I will gladly search it for you.\" do not need grounding.",
+"id": "GoogleCloudDiscoveryengineV1AssistantGroundedContent",
 "properties": {
-"searchResults": {
-"description": "Search results observed by the search action, it can be snippets info or chunk info, depending on the citation type set by the user.",
-"items": {
-"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResult"
+"content": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistantContent",
+"description": "The content."
 },
-"type": "array"
+"textGroundingMetadata": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadata",
+"description": "Metadata for grounding based on text sources."
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResult": {
-"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResult",
+"GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadata": {
+"description": "Grounding details for text sources.",
+"id": "GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadata",
 "properties": {
-"chunkInfo": {
-"description": "If citation_type is CHUNK_LEVEL_CITATION and chunk mode is on, populate chunk info.",
+"references": {
+"description": "References for the grounded text.",
 "items": {
-"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultChunkInfo"
+"$ref": "GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataReference"
 },
 "type": "array"
 },
-"document": {
-"description": "Document resource name.",
-"type": "string"
-},
-"snippetInfo": {
-"description": "If citation_type is DOCUMENT_LEVEL_CITATION, populate document level snippets.",
+"segments": {
+"description": "Grounding information for parts of the text.",
 "items": {
-"$ref": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultSnippetInfo"
+"$ref": "GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataSegment"
 },
 "type": "array"
+}
 },
-"structData": {
-"additionalProperties": {
-"description": "Properties of the object.",
-"type": "any"
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataReference": {
+"description": "Referenced content and related document metadata.",
+"id": "GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataReference",
+"properties": {
+"content": {
+"description": "Referenced text content.",
+"type": "string"
+},
+"documentMetadata": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataReferenceDocumentMetadata",
+"description": "Document metadata."
+}
 },
-"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result.",
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataReferenceDocumentMetadata": {
+"description": "Document metadata.",
+"id": "GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataReferenceDocumentMetadata",
+"properties": {
+"document": {
+"description": "Document resource name.",
+"type": "string"
+},
+"domain": {
+"description": "Domain name from the document URI. Note that the `uri` field may contain a URL that redirects to the actual website, in which case this will contain the domain name of the target site.",
+"type": "string"
+},
+"pageIdentifier": {
+"description": "Page identifier.",
+"type": "string"
+},
 "title": {
 "description": "Title.",
 "type": "string"
 },
 "uri": {
-"description": "URI for the document.",
+"description": "URI for the document. It may contain a URL that redirects to the actual website.",
 "type": "string"
 }
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultChunkInfo": {
-"description": "Chunk information.",
-"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultChunkInfo",
+"GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataSegment": {
+"description": "Grounding information for a segment of the text.",
+"id": "GoogleCloudDiscoveryengineV1AssistantGroundedContentTextGroundingMetadataSegment",
 "properties": {
-"chunk": {
-"description": "Chunk resource name.",
-"type": "string"
-},
-"content": {
-"description": "Chunk textual content.",
+"endIndex": {
+"description": "End of the segment, exclusive.",
+"format": "int64",
 "type": "string"
 },
-"relevanceScore": {
-"description": "The relevance of the chunk for a given query. Values range from 0.0 (completely irrelevant) to 1.0 (completely relevant). This value is for informational purpose only. It may change for the same query and chunk at any time due to a model retraining or change in implementation.",
+"groundingScore": {
+"description": "Score for the segment.",
 "format": "float",
 "type": "number"
-}
 },
-"type": "object"
+"referenceIndices": {
+"description": "References for the segment.",
+"items": {
+"format": "int32",
+"type": "integer"
 },
-"GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultSnippetInfo": {
-"description": "Snippet information.",
-"id": "GoogleCloudDiscoveryengineV1AnswerStepActionObservationSearchResultSnippetInfo",
-"properties": {
-"snippet": {
-"description": "Snippet content.",
-"type": "string"
+"type": "array"
 },
-"snippetStatus": {
-"description": "Status of the snippet defined by the search team.",
+"startIndex": {
+"description": "Zero-based index indicating the start of the segment, measured in bytes of a UTF-8 string (i.e. characters encoded on multiple bytes have a length of more than one).",
+"format": "int64",
 "type": "string"
-}
-},
-"type": "object"
 },
-"GoogleCloudDiscoveryengineV1AnswerStepActionSearchAction": {
-"description": "Search action.",
-"id": "GoogleCloudDiscoveryengineV1AnswerStepActionSearchAction",
-"properties": {
-"query": {
-"description": "The query to search.",
+"text": {
+"description": "The text segment itself.",
 "type": "string"
 }
 },
@@ -10817,6 +11559,10 @@
 "description": "The layout parsing configurations for documents.",
 "id": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfigLayoutParsingConfig",
 "properties": {
+"enableGetProcessedDocument": {
+"description": "Optional. If true, the processed document will be made available for the GetProcessedDocument API.",
+"type": "boolean"
+},
 "enableImageAnnotation": {
 "description": "Optional. If true, the LLM based annotation is added to the image during parsing.",
 "type": "boolean"
@@ -10971,7 +11717,7 @@
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.",
 "type": "object"
 },
 "industryVertical": {
@@ -11627,7 +12373,7 @@
 "description": "Cloud Storage location for the input content."
 },
 "idField": {
-"description": "The field indicates the ID field or column to be used as unique IDs of the documents. For GcsSource it is the key of the JSON field. For instance, `my_id` for JSON `{\"my_id\": \"some_uuid\"}`. For others, it may be the column name of the table where the unique ids are stored. The values of the JSON field or the table column are used as the Document.ids. The JSON field or the table column must be of string type, and the values must be set as valid strings conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) with 1-63 characters. Otherwise, documents without valid IDs fail to be imported. Only set this field when auto_generate_ids is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown. If it is unset, a default value `_id` is used when importing from the allowed data sources. Supported data sources: * GcsSource. GcsSource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * BigQuerySource. BigQuerySource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * SpannerSource. * CloudSqlSource. * FirestoreSource. * BigtableSource.",
+"description": "The field indicates the ID field or column to be used as unique IDs of the documents. For GcsSource it is the key of the JSON field. For instance, `my_id` for JSON `{\"my_id\": \"some_uuid\"}`. For others, it may be the column name of the table where the unique ids are stored. The values of the JSON field or the table column are used as the Document.ids. The JSON field or the table column must be of string type, and the values must be set as valid strings conform to [RFC-1034](https://tools.ietf.org/html/rfc1034) with 1-63 characters. Otherwise, documents without valid IDs fail to be imported. Only set this field when auto_generate_ids is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown. If it is unset, a default value `_id` is used when importing from the allowed data sources. Supported data sources: * GcsSource. GcsSource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * BigQuerySource. BigQuerySource.data_schema must be `custom` or `csv`. Otherwise, an INVALID_ARGUMENT error is thrown. * SpannerSource. * CloudSqlSource. * BigtableSource.",
 "type": "string"
 },
 "inlineSource": {
@@ -13067,7 +13813,7 @@
 "description": "Search as you type configuration. Only supported for the IndustryVertical.MEDIA vertical."
 },
 "session": {
-"description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Auto-session mode: when `projects/.../sessions/-` is used, a new session gets automatically created. Otherwise, users can use the create-session API to create a session manually. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
+"description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
 "type": "string"
 },
 "sessionSpec": {
@@ -14294,6 +15040,148 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1StreamAssistRequest": {
+"description": "Request for the AssistantService.StreamAssist method.",
+"id": "GoogleCloudDiscoveryengineV1StreamAssistRequest",
+"properties": {
+"generationSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1StreamAssistRequestGenerationSpec",
+"description": "Optional. Specification of the generation configuration for the request."
+},
+"query": {
+"$ref": "GoogleCloudDiscoveryengineV1Query",
+"description": "Optional. Current user query. Empty query is only supported if `file_ids` are provided. In this case, the answer will be generated based on those context files."
+},
+"session": {
+"description": "Optional. The session to use for the request. If specified, the assistant has access to the session history, and the query and the answer are stored there. If `-` is specified as the session ID, or it is left empty, then a new session is created with an automatically generated ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`",
+"type": "string"
+},
+"toolsSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpec",
+"description": "Optional. Specification of tools that are used to serve the request."
+},
+"userMetadata": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistUserMetadata",
+"description": "Optional. Information about the user initiating the query."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1StreamAssistRequestGenerationSpec": {
+"description": "Assistant generation specification for the request. This allows to override the default generation configuration at the engine level.",
+"id": "GoogleCloudDiscoveryengineV1StreamAssistRequestGenerationSpec",
+"properties": {
+"modelId": {
+"description": "Optional. The Vertex AI model_id used for the generative model. If not set, the default Assistant model will be used.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpec": {
+"description": "Specification of tools that are used to serve the request.",
+"id": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpec",
+"properties": {
+"imageGenerationSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecImageGenerationSpec",
+"description": "Optional. Specification of the image generation tool."
+},
+"toolRegistry": {
+"description": "Optional. The name of the tool registry to use. Format: `projects/{project}/locations/{location}/toolRegistries/{tool_registry}`",
+"type": "string"
+},
+"vertexAiSearchSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecVertexAiSearchSpec",
+"description": "Optional. Specification of the Vertex AI Search tool."
+},
+"videoGenerationSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecVideoGenerationSpec",
+"description": "Optional. Specification of the video generation tool."
+},
+"webGroundingSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecWebGroundingSpec",
+"description": "Optional. Specification of the web grounding tool. If field is present, enables grounding with web search. Works only if Assistant.web_grounding_type is WEB_GROUNDING_TYPE_GOOGLE_SEARCH or WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecImageGenerationSpec": {
+"description": "Specification of the image generation tool.",
+"id": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecImageGenerationSpec",
+"properties": {},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecVertexAiSearchSpec": {
+"description": "Specification of the Vertex AI Search tool.",
+"id": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecVertexAiSearchSpec",
+"properties": {
+"dataStoreSpecs": {
+"description": "Optional. Specs defining DataStores to filter on in a search call and configurations for those data stores. This is only considered for Engines with multiple data stores.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec"
+},
+"type": "array"
+},
+"disabled": {
+"deprecated": true,
+"description": "Optional. Deprecated. Please refrain from using this field. Whether the Vertex AI Search tool is disabled. Default value is false, the tool is enabled by default.",
+"type": "boolean"
+},
+"filter": {
+"description": "Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customer might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY(\"king kong\")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecVideoGenerationSpec": {
+"description": "Specification of the video generation tool.",
+"id": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecVideoGenerationSpec",
+"properties": {},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecWebGroundingSpec": {
+"description": "Specification of the web grounding tool.",
+"id": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecWebGroundingSpec",
+"properties": {
+"enabled": {
+"deprecated": true,
+"description": "Optional. Deprecated. Please refrain from using this field. Whether the web grounding tool is enabled.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1StreamAssistResponse": {
+"description": "Response for the AssistantService.StreamAssist method.",
+"id": "GoogleCloudDiscoveryengineV1StreamAssistResponse",
+"properties": {
+"answer": {
+"$ref": "GoogleCloudDiscoveryengineV1AssistAnswer",
+"description": "Assist answer resource object containing parts of the assistant's final answer for the user's query. Not present if the current response doesn't add anything to previously sent AssistAnswer.replies. Observe AssistAnswer.state to see if more parts are to be expected. While the state is `IN_PROGRESS`, the AssistAnswer.replies field in each response will contain replies (reply fragments) to be appended to the ones received in previous responses. AssistAnswer.name won't be filled. If the state is `SUCCEEDED`, `FAILED` or `SKIPPED`, the response is the last response and AssistAnswer.name will have a value."
+},
+"assistToken": {
+"description": "A global unique ID that identifies the current pair of request and stream of responses. Used for feedback and support.",
+"type": "string"
+},
+"sessionInfo": {
+"$ref": "GoogleCloudDiscoveryengineV1StreamAssistResponseSessionInfo",
+"description": "Session information."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1StreamAssistResponseSessionInfo": {
+"description": "Information about the session.",
+"id": "GoogleCloudDiscoveryengineV1StreamAssistResponseSessionInfo",
+"properties": {
+"session": {
+"description": "Name of the newly generated or continued session. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1SuggestionDenyListEntry": {
 "description": "Suggestion deny list entry identifying the phrase to block from suggestions and the applied operation for the phrase.",
 "id": "GoogleCloudDiscoveryengineV1SuggestionDenyListEntry",
@@ -14776,14 +15664,16 @@
 "ASSIGNED",
 "UNASSIGNED",
 "NO_LICENSE",
-"NO_LICENSE_ATTEMPTED_LOGIN"
+"NO_LICENSE_ATTEMPTED_LOGIN",
+"BLOCKED"
 ],
 "enumDescriptions": [
 "Default value.",
 "License assigned to the user.",
 "No license assigned to the user. Deprecated, translated to NO_LICENSE.",
 "No license assigned to the user.",
-"User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin)."
+"User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin).",
+"User is blocked from assigning a license."
 ],
 "readOnly": true,
 "type": "string"
@@ -15945,7 +16835,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaConnectorRunEntityRun",
 "properties": {
 "deletedRecordCount": {
-"description": "The number of documents deleted.",
+"description": "Optional. The number of documents deleted.",
 "format": "int64",
 "type": "string"
 },
@@ -15954,7 +16844,7 @@
 "type": "string"
 },
 "errorRecordCount": {
-"description": "The total number of documents failed at sync at any stage (extraction, indexing, etc).",
+"description": "Optional. The total number of documents failed at sync at indexing stage.",
 "format": "int64",
 "type": "string"
 },
@@ -15966,12 +16856,12 @@
 "type": "array"
 },
 "extractedRecordCount": {
-"description": "The number of documents extracted from connector source, ready to be ingested to VAIS.",
+"description": "Optional. The number of documents extracted from connector source, ready to be ingested to VAIS.",
 "format": "int64",
 "type": "string"
 },
 "indexedRecordCount": {
-"description": "The number of documents indexed.",
+"description": "Optional. The number of documents indexed.",
 "format": "int64",
 "type": "string"
 },
@@ -15980,12 +16870,12 @@
 "description": "Metadata to generate the progress bar."
 },
 "scheduledRecordCount": {
-"description": "The number of documents scheduled to be crawled/extracted from connector source. This only applies to third party connectors.",
+"description": "Optional. The number of documents scheduled to be crawled/extracted from connector source. This only applies to third party connectors.",
 "format": "int64",
 "type": "string"
 },
 "sourceApiRequestCount": {
-"description": "The number of requests sent to 3p API.",
+"description": "Optional. The number of requests sent to 3p API.",
 "format": "int64",
 "type": "string"
 },
@@ -16517,7 +17407,8 @@
 "GOOGLE_DRIVE",
 "NATIVE_CLOUD_IDENTITY",
 "THIRD_PARTY_FEDERATED",
-"THIRD_PARTY_EUA"
+"THIRD_PARTY_EUA",
+"GCNV"
 ],
 "enumDescriptions": [
 "Default value.",
@@ -16530,7 +17421,8 @@
 "Google Drive connector.",
 "Native Cloud Identity connector for people search powered by People API.",
 "Federated connector, it is a third party connector that doesn't ingestion data, and search is powered by third party application's API.",
-"Connector utilized for End User Authentication features."
+"Connector utilized for End User Authentication features.",
+"Google Cloud NetApp Volumes connector."
 ],
 "readOnly": true,
 "type": "string"
@@ -16708,14 +17600,12 @@
 "enum": [
 "PERIODIC",
 "STREAMING",
-"UNSPECIFIED",
-"SCALA_SYNC"
+"UNSPECIFIED"
 ],
 "enumDescriptions": [
 "The connector will sync data periodically based on the refresh_interval. Use it with auto_run_disabled to pause the periodic sync, or indicate a one-time sync.",
 "The data will be synced in real time.",
-"Connector that doesn't ingest data will have this value",
-"The data will be synced with Scala Sync, a data ingestion solution."
+"Connector that doesn't ingest data will have this value"
 ],
 "type": "string"
 },
@@ -16747,6 +17637,10 @@
 },
 "description": "Optional. Any authentication parameters specific to EUA connectors.",
 "type": "object"
+},
+"tenant": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaTenant",
+"description": "Optional. The tenant project the connector is connected to."
 }
 },
 "type": "object"
@@ -16759,6 +17653,10 @@
 "description": "Optional. The ID of the Secret Manager secret used for webhook secret.",
 "type": "string"
 },
+"streamingError": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaDataConnectorRealtimeSyncConfigStreamingError",
+"description": "Optional. Streaming error details."
+},
 "webhookUri": {
 "description": "Optional. Webhook url for the connector to specify additional params for realtime sync.",
 "type": "string"
@@ -16766,6 +17664,33 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaDataConnectorRealtimeSyncConfigStreamingError": {
+"description": "Streaming error details.",
+"id": "GoogleCloudDiscoveryengineV1alphaDataConnectorRealtimeSyncConfigStreamingError",
+"properties": {
+"error": {
+"$ref": "GoogleRpcStatus",
+"description": "Optional. Error details."
+},
+"streamingErrorReason": {
+"description": "Optional. Streaming error.",
+"enum": [
+"STREAMING_ERROR_REASON_UNSPECIFIED",
+"STREAMING_SETUP_ERROR",
+"STREAMING_SYNC_ERROR",
+"INGRESS_ENDPOINT_REQUIRED"
+],
+"enumDescriptions": [
+"Streaming error reason unspecified.",
+"Some error occurred while setting up resources for realtime sync.",
+"Some error was encountered while running realtime sync for the connector.",
+"Ingress endpoint is required when setting up realtime sync in private connectivity."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity": {
 "description": "Represents an entity in the data source. For example, the `Account` object in Salesforce.",
 "id": "GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity",
@@ -17314,6 +18239,10 @@
 "description": "The layout parsing configurations for documents.",
 "id": "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfigLayoutParsingConfig",
 "properties": {
+"enableGetProcessedDocument": {
+"description": "Optional. If true, the processed document will be made available for the GetProcessedDocument API.",
+"type": "boolean"
+},
 "enableImageAnnotation": {
 "description": "Optional. If true, the LLM based annotation is added to the image during parsing.",
 "type": "boolean"
@@ -17447,7 +18376,7 @@
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.",
 "type": "object"
 },
 "industryVertical": {
@@ -18489,7 +19418,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaListSessionsRequest",
 "properties": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: \"user_pseudo_id = some_id\"",
+"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
 "type": "string"
 },
 "orderBy": {
@@ -19340,7 +20269,7 @@
 "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
 },
 "rankingExpression": {
-"description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
+"description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
 "type": "string"
 },
 "rankingExpressionBackend": {
@@ -19407,7 +20336,7 @@ false
 "type": "string"
 },
 "session": {
-"description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Auto-session mode: when `projects/.../sessions/-` is used, a new session gets automatically created. Otherwise, users can use the create-session API to create a session manually. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
+"description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
 "type": "string"
 },
 "sessionSpec": {
@@ -20365,6 +21294,25 @@ false
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaTenant": {
+"description": "Tenant information for a connector source. This includes some of the same information stored in the Credential message, but is limited to only what is needed to provide a list of accessible tenants to the user.",
+"id": "GoogleCloudDiscoveryengineV1alphaTenant",
+"properties": {
+"displayName": {
+"description": "Optional display name for the tenant, e.g. \"My Slack Team\".",
+"type": "string"
+},
+"id": {
+"description": "The tenant's instance ID. Examples: Jira (\"8594f221-9797-5f78-1fa4-485e198d7cd0\"), Slack (\"T123456\").",
+"type": "string"
+},
+"uri": {
+"description": "The URI of the tenant, if applicable. For example, the URI of a Jira instance is https://my-jira-instance.atlassian.net, and a Slack tenant does not have a URI.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaTrainCustomModelMetadata": {
 "description": "Metadata related to the progress of the TrainCustomModel operation. This is returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1alphaTrainCustomModelMetadata",
@@ -20559,14 +21507,16 @@ false
 "ASSIGNED",
 "UNASSIGNED",
 "NO_LICENSE",
-"NO_LICENSE_ATTEMPTED_LOGIN"
+"NO_LICENSE_ATTEMPTED_LOGIN",
+"BLOCKED"
 ],
 "enumDescriptions": [
 "Default value.",
 "License assigned to the user.",
 "No license assigned to the user. Deprecated, translated to NO_LICENSE.",
 "No license assigned to the user.",
-"User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin)."
+"User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin).",
+"User is blocked from assigning a license."
 ],
 "readOnly": true,
 "type": "string"
@@ -21618,6 +22568,10 @@ false
 "description": "The layout parsing configurations for documents.",
 "id": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfigLayoutParsingConfig",
 "properties": {
+"enableGetProcessedDocument": {
+"description": "Optional. If true, the processed document will be made available for the GetProcessedDocument API.",
+"type": "boolean"
+},
 "enableImageAnnotation": {
 "description": "Optional. If true, the LLM based annotation is added to the image during parsing.",
 "type": "boolean"
@@ -21751,7 +22705,7 @@ false
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` - Enables personalization based on user preferences.",
 "type": "object"
 },
 "industryVertical": {
@@ -22934,7 +23888,7 @@ false
 "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
 },
 "rankingExpression": {
-"description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
+"description": "Optional. The ranking expression controls the customized ranking on retrieval documents. This overrides ServingConfig.ranking_expression. The syntax and supported features depend on the `ranking_expression_backend` value. If `ranking_expression_backend` is not provided, it defaults to `RANK_BY_EMBEDDING`. If ranking_expression_backend is not provided or set to `RANK_BY_EMBEDDING`, it should be a single function or multiple functions that are joined by \"+\". * ranking_expression = function, { \" + \", function }; Supported functions: * double * relevance_score * double * dotProduct(embedding_field_path) Function variables: * `relevance_score`: pre-defined keywords, used for measure relevance between query and document. * `embedding_field_path`: the document embedding field used with query embedding vector. * `dotProduct`: embedding function between `embedding_field_path` and query embedding vector. Example ranking expression: If document has an embedding field doc_embedding, the ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. If ranking_expression_backend is set to `RANK_BY_FORMULA`, the following expression types (and combinations of those chained using + or * operators) are supported: * `double` * `signal` * `log(signal)` * `exp(signal)` * `rr(signal, double > 0)` -- reciprocal rank transformation with second argument being a denominator constant. * `is_nan(signal)` -- returns 0 if signal is NaN, 1 otherwise. * `fill_nan(signal1, signal2 | double)` -- if signal1 is NaN, returns signal2 | double, else returns signal1. Here are a few examples of ranking formulas that use the supported ranking expression types: - `0.2 * semantic_similarity_score + 0.8 * log(keyword_similarity_score)` -- mostly rank by the logarithm of `keyword_similarity_score` with slight `semantic_smilarity_score` adjustment. - `0.2 * exp(fill_nan(semantic_similarity_score, 0)) + 0.3 * is_nan(keyword_similarity_score)` -- rank by the exponent of `semantic_similarity_score` filling the value with 0 if it's NaN, also add constant 0.3 adjustment to the final score if `semantic_similarity_score` is NaN. - `0.2 * rr(semantic_similarity_score, 16) + 0.8 * rr(keyword_similarity_score, 16)` -- mostly rank by the reciprocal rank of `keyword_similarity_score` with slight adjustment of reciprocal rank of `semantic_smilarity_score`. The following signals are supported: * `semantic_similarity_score`: semantic similarity adjustment that is calculated using the embeddings generated by a proprietary Google model. This score determines how semantically similar a search query is to a document. * `keyword_similarity_score`: keyword match adjustment uses the Best Match 25 (BM25) ranking function. This score is calculated using a probabilistic model to estimate the probability that a document is relevant to a given query. * `relevance_score`: semantic relevance adjustment that uses a proprietary Google model to determine the meaning and intent behind a user's query in context with the content in the documents. * `pctr_rank`: predicted conversion rate adjustment as a rank use predicted Click-through rate (pCTR) to gauge the relevance and attractiveness of a search result from a user's perspective. A higher pCTR suggests that the result is more likely to satisfy the user's query and intent, making it a valuable signal for ranking. * `freshness_rank`: freshness adjustment as a rank * `document_age`: The time in hours elapsed since the document was last updated, a floating-point number (e.g., 0.25 means 15 minutes). * `topicality_rank`: topicality adjustment as a rank. Uses proprietary Google model to determine the keyword-based overlap between the query and the document. * `base_rank`: the default rank of the result",
 "type": "string"
 },
 "rankingExpressionBackend": {
@@ -23001,7 +23955,7 @@ false
 "type": "string"
 },
 "session": {
-"description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): 1. Call /search API with the auto-session mode (see below). 2. Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Auto-session mode: when `projects/.../sessions/-` is used, a new session gets automatically created. Otherwise, users can use the create-session API to create a session manually. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
+"description": "The session resource name. Optional. Session allows users to do multi-turn /search API calls or coordination between /search API calls and /answer API calls. Example #1 (multi-turn /search API calls): Call /search API with the session ID generated in the first call. Here, the previous search query gets considered in query standing. I.e., if the first query is \"How did Alphabet do in 2022?\" and the current query is \"How about 2023?\", the current query will be interpreted as \"How did Alphabet do in 2023?\". Example #2 (coordination between /search API calls and /answer API calls): Call /answer API with the session ID generated in the first call. Here, the answer generation happens in the context of the search results from the first search call. Multi-turn Search feature is currently at private GA stage. Please use v1alpha or v1beta version instead before we launch this feature to public GA. Or ask for allowlisting through Google Support team.",
 "type": "string"
 },
 "sessionSpec": {
@@ -23989,14 +24943,16 @@ false
 "ASSIGNED",
 "UNASSIGNED",
 "NO_LICENSE",
-"NO_LICENSE_ATTEMPTED_LOGIN"
+"NO_LICENSE_ATTEMPTED_LOGIN",
+"BLOCKED"
 ],
 "enumDescriptions": [
 "Default value.",
 "License assigned to the user.",
 "No license assigned to the user. Deprecated, translated to NO_LICENSE.",
 "No license assigned to the user.",
-"User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin)."
+"User attempted to login but no license assigned to the user. This state is only used for no user first time login attempt but cannot get license assigned. Users already logged in but cannot get license assigned will be assigned NO_LICENSE state(License could be unassigned by admin).",
+"User is blocked from assigning a license."
 ],
 "readOnly": true,
 "type": "string"