google-api-python-client 2.172.0__py3-none-any.whl → 2.173.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/dataproc.v1.json

@@ -4998,7 +4998,7 @@
 }
 }
 },
-"revision": "20250521",
+"revision": "20250604",
 "rootUrl": "https://dataproc.googleapis.com/",
 "schemas": {
 "AcceleratorConfig": {
@@ -5472,8 +5472,8 @@
 ],
 "enumDescriptions": [
 "Not set.",
-"Standard dataproc cluster with minimum 2 primary workers.",
-"Clusters that can be scaled down to zero worker nodes."
+"Standard dataproc cluster with a minimum of two primary workers.",
+"Clusters that can use only secondary workers and be scaled down to zero secondary worker nodes."
 ],
 "type": "string"
 },
@@ -5893,6 +5893,20 @@
 },
 "type": "array"
 },
+"clusterTier": {
+"description": "Optional. The tier of the cluster.",
+"enum": [
+"CLUSTER_TIER_UNSPECIFIED",
+"CLUSTER_TIER_STANDARD",
+"CLUSTER_TIER_PREMIUM"
+],
+"enumDescriptions": [
+"Not set. Works the same as CLUSTER_TIER_STANDARD.",
+"Standard dataproc cluster.",
+"Premium dataproc cluster."
+],
+"type": "string"
+},
 "clusterType": {
 "description": "Optional. The type of the cluster.",
 "enum": [
@@ -5905,7 +5919,7 @@
 "Not set.",
 "Standard dataproc cluster with a minimum of two primary workers.",
 "https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/single-node-clusters",
-"Clusters that can be scaled down to zero worker nodes."
+"Clusters that can use only secondary workers and be scaled down to zero secondary worker nodes."
 ],
 "type": "string"
 },

googleapiclient/discovery_cache/documents/dialogflow.v2.json

@@ -8805,7 +8805,7 @@
 }
 }
 },
-"revision": "20250602",
+"revision": "20250612",
 "rootUrl": "https://dialogflow.googleapis.com/",
 "schemas": {
 "GoogleCloudDialogflowCxV3AdvancedSettings": {
@@ -20063,7 +20063,7 @@ true
 "id": "GoogleCloudDialogflowV2ToolCall",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "createTime": {
@@ -20081,7 +20081,7 @@ true
 "type": "object"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -20092,7 +20092,7 @@ true
 "id": "GoogleCloudDialogflowV2ToolCallResult",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "content": {
@@ -20115,7 +20115,7 @@ true
 "type": "string"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -23110,7 +23110,7 @@ true
 "id": "GoogleCloudDialogflowV2beta1ToolCall",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "createTime": {
@@ -23128,7 +23128,7 @@ true
 "type": "object"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -23139,7 +23139,7 @@ true
 "id": "GoogleCloudDialogflowV2beta1ToolCallResult",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "content": {
@@ -23162,7 +23162,7 @@ true
 "type": "string"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },

googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json

@@ -8602,7 +8602,7 @@
 }
 }
 },
-"revision": "20250602",
+"revision": "20250612",
 "rootUrl": "https://dialogflow.googleapis.com/",
 "schemas": {
 "GoogleCloudDialogflowCxV3AdvancedSettings": {
@@ -15863,7 +15863,7 @@ true
 "id": "GoogleCloudDialogflowV2ToolCall",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "createTime": {
@@ -15881,7 +15881,7 @@ true
 "type": "object"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -15892,7 +15892,7 @@ true
 "id": "GoogleCloudDialogflowV2ToolCallResult",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "content": {
@@ -15915,7 +15915,7 @@ true
 "type": "string"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -22982,7 +22982,7 @@ true
 "id": "GoogleCloudDialogflowV2beta1ToolCall",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "createTime": {
@@ -23000,7 +23000,7 @@ true
 "type": "object"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -23011,7 +23011,7 @@ true
 "id": "GoogleCloudDialogflowV2beta1ToolCallResult",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "content": {
@@ -23034,7 +23034,7 @@ true
 "type": "string"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },

googleapiclient/discovery_cache/documents/dialogflow.v3.json

@@ -5309,7 +5309,7 @@
 }
 }
 },
-"revision": "20250602",
+"revision": "20250612",
 "rootUrl": "https://dialogflow.googleapis.com/",
 "schemas": {
 "GoogleCloudDialogflowCxV3Action": {
@@ -9840,6 +9840,10 @@ false
 "$ref": "GoogleCloudDialogflowCxV3LlmModelSettings",
 "description": "Optional. Use the specified LLM model settings for processing the request."
 },
+"parameterScope": {
+"description": "Scope for the parameters. If not specified, parameters will be treated as session parameters. Parameters with custom scope will not be put into session parameters. You can reference the parameters with custom scope in the agent with the following format: $parameter-scope.params.parameter-id.",
+"type": "string"
+},
 "parameters": {
 "additionalProperties": {
 "description": "Properties of the object.",
@@ -17140,7 +17144,7 @@ true
 "id": "GoogleCloudDialogflowV2ToolCall",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "createTime": {
@@ -17158,7 +17162,7 @@ true
 "type": "object"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -17169,7 +17173,7 @@ true
 "id": "GoogleCloudDialogflowV2ToolCallResult",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "content": {
@@ -17192,7 +17196,7 @@ true
 "type": "string"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -20053,7 +20057,7 @@ true
 "id": "GoogleCloudDialogflowV2beta1ToolCall",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "createTime": {
@@ -20071,7 +20075,7 @@ true
 "type": "object"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -20082,7 +20086,7 @@ true
 "id": "GoogleCloudDialogflowV2beta1ToolCallResult",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "content": {
@@ -20105,7 +20109,7 @@ true
 "type": "string"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },

googleapiclient/discovery_cache/documents/dialogflow.v3beta1.json

@@ -5436,7 +5436,7 @@
 }
 }
 },
-"revision": "20250602",
+"revision": "20250612",
 "rootUrl": "https://dialogflow.googleapis.com/",
 "schemas": {
 "GoogleCloudDialogflowCxV3AdvancedSettings": {
@@ -13321,6 +13321,10 @@ false
 "$ref": "GoogleCloudDialogflowCxV3beta1LlmModelSettings",
 "description": "Optional. Use the specified LLM model settings for processing the request."
 },
+"parameterScope": {
+"description": "Scope for the parameters. If not specified, parameters will be treated as session parameters. Parameters with custom scope will not be put into session parameters. You can reference the parameters with custom scope in the agent with the following format: $parameter-scope.params.parameter-id.",
+"type": "string"
+},
 "parameters": {
 "additionalProperties": {
 "description": "Properties of the object.",
@@ -18510,7 +18514,7 @@ true
 "id": "GoogleCloudDialogflowV2ToolCall",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "createTime": {
@@ -18528,7 +18532,7 @@ true
 "type": "object"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -18539,7 +18543,7 @@ true
 "id": "GoogleCloudDialogflowV2ToolCallResult",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "content": {
@@ -18562,7 +18566,7 @@ true
 "type": "string"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -21423,7 +21427,7 @@ true
 "id": "GoogleCloudDialogflowV2beta1ToolCall",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "createTime": {
@@ -21441,7 +21445,7 @@ true
 "type": "object"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },
@@ -21452,7 +21456,7 @@ true
 "id": "GoogleCloudDialogflowV2beta1ToolCallResult",
 "properties": {
 "action": {
-"description": "Required. The name of the tool's action associated with this call.",
+"description": "Optional. The name of the tool's action associated with this call.",
 "type": "string"
 },
 "content": {
@@ -21475,7 +21479,7 @@ true
 "type": "string"
 },
 "tool": {
-"description": "Required. The tool associated with this call. Format: `projects//locations//tools/`.",
+"description": "Optional. The tool associated with this call. Format: `projects//locations//tools/`.",
 "type": "string"
 }
 },

googleapiclient/discovery_cache/documents/discoveryengine.v1.json

@@ -7052,7 +7052,7 @@
 }
 }
 },
-"revision": "20250604",
+"revision": "20250609",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -12238,6 +12238,10 @@
 "description": "Principal identifier of a user or a group.",
 "id": "GoogleCloudDiscoveryengineV1Principal",
 "properties": {
+"externalEntityId": {
+"description": "For 3P application identities which are not present in the customer identity provider.",
+"type": "string"
+},
 "groupId": {
 "description": "Group identifier. For Google Workspace user account, group_id should be the google workspace group email. For non-google identity provider user account, group_id is the mapped group identifier configured during the workforcepool config.",
 "type": "string"
@@ -12582,7 +12586,8 @@
 "id": "GoogleCloudDiscoveryengineV1Query",
 "properties": {
 "queryId": {
-"description": "Unique Id for the query.",
+"description": "Output only. Unique Id for the query.",
+"readOnly": true,
 "type": "string"
 },
 "text": {
@@ -14168,7 +14173,7 @@
 "id": "GoogleCloudDiscoveryengineV1SessionTurn",
 "properties": {
 "answer": {
-"description": "The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn.",
+"description": "Optional. The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn.",
 "type": "string"
 },
 "detailedAnswer": {
@@ -14178,14 +14183,7 @@
 },
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1Query",
-"description": "The user query."
-},
-"queryConfigs": {
-"additionalProperties": {
-"type": "string"
-},
-"description": "Optional. Represents metadata related to the query config, for example LLM model and version used, model parameters (temperature, grounding parameters, etc.). We don't want to import directly the [AnswerGenerationSpec] structure as this will serve a more general purpose and a wider set of customers. This information is used in particular when rendering alternative answers to the same prompt, providing visual information about how each answer was generated. The prefix \"google.\" will be reserved for the key, and 1P services (Answer, Assistant, etc.) should always store their information with \"google..\". 3P services can use anything not starting with \"google.\"",
-"type": "object"
+"description": "Optional. The user query. May not be set if this turn is merely regenerating an answer to a different turn"
 }
 },
 "type": "object"
@@ -18863,7 +18861,8 @@
 "id": "GoogleCloudDiscoveryengineV1alphaQuery",
 "properties": {
 "queryId": {
-"description": "Unique Id for the query.",
+"description": "Output only. Unique Id for the query.",
+"readOnly": true,
 "type": "string"
 },
 "text": {
@@ -19303,7 +19302,7 @@
 "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
 },
 "rankingExpression": {
-"description": "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 BYOE. === BYOE === If ranking_expression_backend is not provided or set to `BYOE`, 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)`. === CLEARBOX === If ranking_expression_backend is set to `CLEARBOX`, 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. Examples: * 0.2 * gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(fill_nan(gecko_score, 0)) + 0.3 * is_nan(bm25_score) * 0.2 * rr(gecko_score, 16) + 0.8 * rr(bm25_score, 32) The following signals are supported: * gecko_score -- semantic similarity adjustment * bm25_score -- keyword match adjustment * jetstream_score -- semantic relevance adjustment * pctr_rank -- predicted conversion rate adjustment as a rank * freshness_rank -- freshness adjustment as a rank * 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 * `base_rank`: the default rank of the result",
 "type": "string"
 },
 "rankingExpressionBackend": {
@@ -19311,12 +19310,23 @@
 "enum": [
 "RANKING_EXPRESSION_BACKEND_UNSPECIFIED",
 "BYOE",
-"CLEARBOX"
+"CLEARBOX",
+"RANK_BY_EMBEDDING",
+"RANK_BY_FORMULA"
+],
+"enumDeprecated": [
+false,
+true,
+true,
+false,
+false
 ],
 "enumDescriptions": [
 "Default option for unspecified/unknown values.",
-"Bring your own embedding (BYOE), the default way to evaluate the ranking expression.",
-"The expression is compiled into a Clearbox formula."
+"Deprecated: Use `RANK_BY_EMBEDDING` instead. Ranking by custom embedding model, the default way to evaluate the ranking expression. Legacy enum option, `RANK_BY_EMBEDDING` should be used instead.",
+"Deprecated: Use `RANK_BY_FORMULA` instead. Ranking by custom formula. Legacy enum option, `RANK_BY_FORMULA` should be used instead.",
+"Ranking by custom embedding model, the default way to evaluate the ranking expression.",
+"Ranking by custom formula."
 ],
 "type": "string"
 },
@@ -19370,6 +19380,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestSpellCorrectionSpec",
 "description": "The spell correction specification that specifies the mode under which spell correction takes effect."
 },
+"useLatestData": {
+"description": "Uses the Engine, ServingConfig and Control freshly read from the database. Note: this skips config cache and introduces dependency on databases, which could significantly increase the API latency. It should only be used for testing, but not serving end users.",
+"type": "boolean"
+},
 "userInfo": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaUserInfo",
 "description": "Information about the end user. Highly recommended for analytics and personalization. UserInfo.user_agent is used to deduce `device_type` for analytics."
@@ -20052,7 +20066,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaSessionTurn",
 "properties": {
 "answer": {
-"description": "The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn.",
+"description": "Optional. The resource name of the answer to the user query. Only set if the answer generation (/answer API call) happened in this turn.",
 "type": "string"
 },
 "detailedAnswer": {
@@ -20062,14 +20076,7 @@
 },
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaQuery",
-"description": "The user query."
-},
-"queryConfigs": {
-"additionalProperties": {
-"type": "string"
-},
-"description": "Optional. Represents metadata related to the query config, for example LLM model and version used, model parameters (temperature, grounding parameters, etc.). We don't want to import directly the [AnswerGenerationSpec] structure as this will serve a more general purpose and a wider set of customers. This information is used in particular when rendering alternative answers to the same prompt, providing visual information about how each answer was generated. The prefix \"google.\" will be reserved for the key, and 1P services (Answer, Assistant, etc.) should always store their information with \"google..\". 3P services can use anything not starting with \"google.\"",
-"type": "object"
+"description": "Optional. The user query. May not be set if this turn is merely regenerating an answer to a different turn"
 }
 },
 "type": "object"
@@ -22882,7 +22889,7 @@
 "description": "The query expansion specification that specifies the conditions under which query expansion occurs."
 },
 "rankingExpression": {
-"description": "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 BYOE. === BYOE === If ranking_expression_backend is not provided or set to `BYOE`, 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)`. === CLEARBOX === If ranking_expression_backend is set to `CLEARBOX`, 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. Examples: * 0.2 * gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(fill_nan(gecko_score, 0)) + 0.3 * is_nan(bm25_score) * 0.2 * rr(gecko_score, 16) + 0.8 * rr(bm25_score, 32) The following signals are supported: * gecko_score -- semantic similarity adjustment * bm25_score -- keyword match adjustment * jetstream_score -- semantic relevance adjustment * pctr_rank -- predicted conversion rate adjustment as a rank * freshness_rank -- freshness adjustment as a rank * 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 * `base_rank`: the default rank of the result",
 "type": "string"
 },
 "rankingExpressionBackend": {
@@ -22890,12 +22897,23 @@
 "enum": [
 "RANKING_EXPRESSION_BACKEND_UNSPECIFIED",
 "BYOE",
-"CLEARBOX"
+"CLEARBOX",
+"RANK_BY_EMBEDDING",
+"RANK_BY_FORMULA"
+],
+"enumDeprecated": [
+false,
+true,
+true,
+false,
+false
 ],
 "enumDescriptions": [
 "Default option for unspecified/unknown values.",
-"Bring your own embedding (BYOE), the default way to evaluate the ranking expression.",
-"The expression is compiled into a Clearbox formula."
+"Deprecated: Use `RANK_BY_EMBEDDING` instead. Ranking by custom embedding model, the default way to evaluate the ranking expression. Legacy enum option, `RANK_BY_EMBEDDING` should be used instead.",
+"Deprecated: Use `RANK_BY_FORMULA` instead. Ranking by custom formula. Legacy enum option, `RANK_BY_FORMULA` should be used instead.",
+"Ranking by custom embedding model, the default way to evaluate the ranking expression.",
+"Ranking by custom formula."
 ],
 "type": "string"
 },