google-api-python-client 2.153.0__py2.py3-none-any.whl → 2.154.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json

@@ -15,6 +15,28 @@
 "description": "Discovery Engine API.",
 "discoveryVersion": "v1",
 "documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/",
+"endpoints": [
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.asia-northeast1.rep.googleapis.com/",
+"location": "asia-northeast1"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.europe-west2.rep.googleapis.com/",
+"location": "europe-west2"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.us.rep.googleapis.com/",
+"location": "us"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/",
+"location": "eu"
+}
+],
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -7823,6 +7845,34 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"import": {
+"description": "Bulk import of user events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/userEvents:import",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.userEvents.import",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. Parent DataStore resource name, of the form `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+parent}/userEvents:import",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaImportUserEventsRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "write": {
 "description": "Writes a single user event.",
 "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/userEvents:write",
@@ -8007,7 +8057,7 @@
 }
 }
 },
-"revision": "20241031",
+"revision": "20241110",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -10719,7 +10769,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 }
@@ -11630,7 +11680,7 @@
 "type": "integer"
 },
 "groundingCheckRequired": {
-"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices, anti_citation_indices, and score should not be returned.",
+"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices should not be returned.",
 "type": "boolean"
 },
 "startPos": {
@@ -11695,20 +11745,8 @@
 "$ref": "GoogleTypeExpr",
 "description": "The condition for evaluating the requirement result."
 },
-"requirementResult": {
-"description": "Requirement result, e.g. pass or fail.",
-"enum": [
-"UNKNOWN",
-"SUCCESS",
-"FAILURE",
-"WARNING"
-],
-"enumDescriptions": [
-"The requirement is unknown.",
-"The requirement check is passed.",
-"The requirement check fails to meet at least one blocking threshold.",
-"The requirement check fails at least one warning threshold, but passes all blocking thresholds."
-],
+"result": {
+"description": "The result of the requirement. It should be one of the `severity` fields in the requirement definition. If any error happens during the evaluation, it will be `UNKNOWN`.",
 "type": "string"
 }
 },
@@ -11781,7 +11819,7 @@
 "description": "Page span of the chunk."
 },
 "relevanceScore": {
-"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchService.SearchResponse.",
+"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchResponse.",
 "format": "double",
 "readOnly": true,
 "type": "number"
@@ -13047,6 +13085,11 @@
 "description": "Detailed document information associated with a user event.",
 "id": "GoogleCloudDiscoveryengineV1alphaDocumentInfo",
 "properties": {
+"conversionValue": {
+"description": "Optional. The conversion value associated with this Document. Must be set if UserEvent.event_type is \"conversion\". For example, a value of 1000 signifies that 1000 seconds were spent viewing a Document for the `watch` conversion type.",
+"format": "float",
+"type": "number"
+},
 "id": {
 "description": "The Document resource ID.",
 "type": "string"
@@ -13749,80 +13792,6 @@
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1alphaFeedback": {
-"description": "Information about the user feedback. This information will be used for logging and metrics purpose.",
-"id": "GoogleCloudDiscoveryengineV1alphaFeedback",
-"properties": {
-"comment": {
-"description": "Optional. The additional user comment of the feedback if user gives a thumb down.",
-"type": "string"
-},
-"conversationInfo": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaFeedbackConversationInfo",
-"description": "The related conversation information when user gives feedback."
-},
-"feedbackType": {
-"description": "Required. Indicate whether the user gives a positive or negative feedback. If the user gives a negative feedback, there might be more feedback details.",
-"enum": [
-"FEEDBACK_TYPE_UNSPECIFIED",
-"LIKE",
-"DISLIKE"
-],
-"enumDescriptions": [
-"Unspecified feedback type.",
-"The user gives a positive feedback.",
-"The user gives a negative feedback."
-],
-"type": "string"
-},
-"llmModelVersion": {
-"description": "The version of the LLM model that was used to generate the response.",
-"type": "string"
-},
-"reasons": {
-"description": "Optional. The reason if user gives a thumb down.",
-"items": {
-"enum": [
-"REASON_UNSPECIFIED",
-"INACCURATE_RESPONSE",
-"NOT_RELEVANT",
-"INCOMPREHENSIVE",
-"OFFENSIVE_OR_UNSAFE",
-"BAD_CIATION",
-"FORMAT_AND_STYLES"
-],
-"enumDescriptions": [
-"Unspecified reason.",
-"The response is inaccurate.",
-"The response is not relevant.",
-"The response is incomprehensive.",
-"The response is offensive or unsafe.",
-"The response is not well-associated with the query.",
-"The response is not well-formatted."
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDiscoveryengineV1alphaFeedbackConversationInfo": {
-"description": "The conversation information such as the question index and session name.",
-"id": "GoogleCloudDiscoveryengineV1alphaFeedbackConversationInfo",
-"properties": {
-"questionIndex": {
-"description": "The index of the user input within the conversation messages.",
-"format": "int32",
-"type": "integer"
-},
-"session": {
-"description": "Name of the newly generated or continued session.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudDiscoveryengineV1alphaFetchDomainVerificationStatusResponse": {
 "description": "Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.",
 "id": "GoogleCloudDiscoveryengineV1alphaFetchDomainVerificationStatusResponse",
@@ -15664,7 +15633,7 @@
 "type": "string"
 },
 "score": {
-"description": "The score of this record based on the given query and selected model.",
+"description": "The score of this record based on the given query and selected model. The score will be rounded to 2 decimal places. If the score is close to 0, it will be rounded to 0.0001 to avoid returning unset.",
 "format": "float",
 "type": "number"
 },
@@ -16007,6 +15976,13 @@
 },
 "type": "array"
 },
+"severity": {
+"description": "The severity of errors if the requirement is not met. It must be ordered from the most strict to the least strict. Examples: * `BLOCKING` * `CRITICAL` * `WARNING` All thresholds in the requirement must have all the severity here.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "thresholdBindings": {
 "description": "A list of threshold bindings to be used in `condition`.",
 "items": {
@@ -16059,21 +16035,34 @@
 "description": "Specifies a multi-level threshold to apply to apply to a `metric_bindings` in the `condition` CEL expression.",
 "id": "GoogleCloudDiscoveryengineV1alphaRequirementThresholdBinding",
 "properties": {
-"blockingThreshold": {
-"description": "Threshold to trigger a blocking failure. If not met, the requirement will evaluate as a `FAILURE`.",
-"format": "double",
-"type": "number"
-},
 "description": {
 "description": "Human readable description of the corresponding threshold and sub-requirement.",
 "type": "string"
 },
+"thresholdValues": {
+"description": "The values of the threshold. The values should be ordered from the most strict to the least strict.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaRequirementThresholdBindingThresholdValue"
+},
+"type": "array"
+},
 "variableId": {
 "description": "The variable id to be referenced in `condition`. Must be unique across all `metric_bindings` and `threshold_bindings`.",
 "type": "string"
+}
 },
-"warningThreshold": {
-"description": "Threshold to trigger a warning. If not met, the requirement will evaluate as a `WARNING`.",
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaRequirementThresholdBindingThresholdValue": {
+"description": "Specifies a threshold value for a given severity.",
+"id": "GoogleCloudDiscoveryengineV1alphaRequirementThresholdBindingThresholdValue",
+"properties": {
+"severity": {
+"description": "The severity of errors if the threshold is not met. It should be one of the `severity` fields in the requirement.",
+"type": "string"
+},
+"value": {
+"description": "The value of the threshold.",
 "format": "double",
 "type": "number"
 }
@@ -16528,7 +16517,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },
@@ -17807,6 +17796,11 @@
 "description": "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": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswer",
+"description": "Output only. In ConversationalSearchService.GetSession API, if GetSessionRequest.include_answer_details is set to true, this field will be populated when getting answer query session.",
+"readOnly": true
+},
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaQuery",
 "description": "The user query."
@@ -18322,6 +18316,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1alphaCompletionInfo",
 "description": "CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search."
 },
+"conversionType": {
+"description": "Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by \"-\", such as \"watch\", \"good-visit\" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc.",
+"type": "string"
+},
 "dataStore": {
 "description": "The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted.",
 "type": "string"
@@ -18347,13 +18345,9 @@
 "type": "string"
 },
 "eventType": {
-"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.",
+"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc. Custom conversion value: * `conversion`: Customer defined conversion event.",
 "type": "string"
 },
-"feedback": {
-"$ref": "GoogleCloudDiscoveryengineV1alphaFeedback",
-"description": "Optional. This field is optional except for the `add-feedback` event types."
-},
 "filter": {
 "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendRequest, this field may be populated directly from RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "type": "string"
@@ -20486,7 +20480,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },

googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json

@@ -15,6 +15,28 @@
 "description": "Discovery Engine API.",
 "discoveryVersion": "v1",
 "documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/",
+"endpoints": [
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.asia-northeast1.rep.googleapis.com/",
+"location": "asia-northeast1"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.europe-west2.rep.googleapis.com/",
+"location": "europe-west2"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.us.rep.googleapis.com/",
+"location": "us"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://discoveryengine.eu.rep.googleapis.com/",
+"location": "eu"
+}
+],
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -7095,6 +7117,34 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"import": {
+"description": "Bulk import of user events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events. Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/userEvents:import",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.userEvents.import",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. Parent DataStore resource name, of the form `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+parent}/userEvents:import",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaImportUserEventsRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "write": {
 "description": "Writes a single user event.",
 "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/userEvents:write",
@@ -7205,7 +7255,7 @@
 }
 }
 },
-"revision": "20241031",
+"revision": "20241110",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -12403,7 +12453,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },
@@ -12877,6 +12927,11 @@
 "description": "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": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswer",
+"description": "Output only. In ConversationalSearchService.GetSession API, if GetSessionRequest.include_answer_details is set to true, this field will be populated when getting answer query session.",
+"readOnly": true
+},
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaQuery",
 "description": "The user query."
@@ -13923,7 +13978,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 }
@@ -14834,7 +14889,7 @@
 "type": "integer"
 },
 "groundingCheckRequired": {
-"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices, anti_citation_indices, and score should not be returned.",
+"description": "Indicates that this claim required grounding check. When the system decided this claim doesn't require attribution/grounding check, this field will be set to false. In that case, no grounding check was done for the claim and therefore citation_indices should not be returned.",
 "type": "boolean"
 },
 "startPos": {
@@ -14896,7 +14951,7 @@
 "description": "Page span of the chunk."
 },
 "relevanceScore": {
-"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchService.SearchResponse.",
+"description": "Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated on SearchResponse.",
 "format": "double",
 "readOnly": true,
 "type": "number"
@@ -16080,6 +16135,11 @@
 "description": "Detailed document information associated with a user event.",
 "id": "GoogleCloudDiscoveryengineV1betaDocumentInfo",
 "properties": {
+"conversionValue": {
+"description": "Optional. The conversion value associated with this Document. Must be set if UserEvent.event_type is \"conversion\". For example, a value of 1000 signifies that 1000 seconds were spent viewing a Document for the `watch` conversion type.",
+"format": "float",
+"type": "number"
+},
 "id": {
 "description": "The Document resource ID.",
 "type": "string"
@@ -16572,80 +16632,6 @@
 },
 "type": "object"
 },
-"GoogleCloudDiscoveryengineV1betaFeedback": {
-"description": "Information about the user feedback. This information will be used for logging and metrics purpose.",
-"id": "GoogleCloudDiscoveryengineV1betaFeedback",
-"properties": {
-"comment": {
-"description": "Optional. The additional user comment of the feedback if user gives a thumb down.",
-"type": "string"
-},
-"conversationInfo": {
-"$ref": "GoogleCloudDiscoveryengineV1betaFeedbackConversationInfo",
-"description": "The related conversation information when user gives feedback."
-},
-"feedbackType": {
-"description": "Required. Indicate whether the user gives a positive or negative feedback. If the user gives a negative feedback, there might be more feedback details.",
-"enum": [
-"FEEDBACK_TYPE_UNSPECIFIED",
-"LIKE",
-"DISLIKE"
-],
-"enumDescriptions": [
-"Unspecified feedback type.",
-"The user gives a positive feedback.",
-"The user gives a negative feedback."
-],
-"type": "string"
-},
-"llmModelVersion": {
-"description": "The version of the LLM model that was used to generate the response.",
-"type": "string"
-},
-"reasons": {
-"description": "Optional. The reason if user gives a thumb down.",
-"items": {
-"enum": [
-"REASON_UNSPECIFIED",
-"INACCURATE_RESPONSE",
-"NOT_RELEVANT",
-"INCOMPREHENSIVE",
-"OFFENSIVE_OR_UNSAFE",
-"BAD_CIATION",
-"FORMAT_AND_STYLES"
-],
-"enumDescriptions": [
-"Unspecified reason.",
-"The response is inaccurate.",
-"The response is not relevant.",
-"The response is incomprehensive.",
-"The response is offensive or unsafe.",
-"The response is not well-associated with the query.",
-"The response is not well-formatted."
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDiscoveryengineV1betaFeedbackConversationInfo": {
-"description": "The conversation information such as the question index and session name.",
-"id": "GoogleCloudDiscoveryengineV1betaFeedbackConversationInfo",
-"properties": {
-"questionIndex": {
-"description": "The index of the user input within the conversation messages.",
-"format": "int32",
-"type": "integer"
-},
-"session": {
-"description": "Name of the newly generated or continued session.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudDiscoveryengineV1betaFetchDomainVerificationStatusResponse": {
 "description": "Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.",
 "id": "GoogleCloudDiscoveryengineV1betaFetchDomainVerificationStatusResponse",
@@ -18071,7 +18057,7 @@
 "type": "string"
 },
 "score": {
-"description": "The score of this record based on the given query and selected model.",
+"description": "The score of this record based on the given query and selected model. The score will be rounded to 2 decimal places. If the score is close to 0, it will be rounded to 0.0001 to avoid returning unset.",
 "format": "float",
 "type": "number"
 },
@@ -18656,7 +18642,7 @@
 "enumDescriptions": [
 "Default value.",
 "Returns documents in the search result.",
-"Returns chunks in the search result. Only available if the DataStore.DocumentProcessingConfig.chunking_config is specified."
+"Returns chunks in the search result. Only available if the DocumentProcessingConfig.chunking_config is specified."
 ],
 "type": "string"
 },
@@ -19927,6 +19913,11 @@
 "description": "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": {
+"$ref": "GoogleCloudDiscoveryengineV1betaAnswer",
+"description": "Output only. In ConversationalSearchService.GetSession API, if GetSessionRequest.include_answer_details is set to true, this field will be populated when getting answer query session.",
+"readOnly": true
+},
 "query": {
 "$ref": "GoogleCloudDiscoveryengineV1betaQuery",
 "description": "The user query."
@@ -20372,6 +20363,10 @@
 "$ref": "GoogleCloudDiscoveryengineV1betaCompletionInfo",
 "description": "CompletionService.CompleteQuery details related to the event. This field should be set for `search` event when autocomplete function is enabled and the user clicks a suggestion for search."
 },
+"conversionType": {
+"description": "Optional. Conversion type. Required if UserEvent.event_type is `conversion`. This is a customer-defined conversion name in lowercase letters or numbers separated by \"-\", such as \"watch\", \"good-visit\" etc. Do not set the field if UserEvent.event_type is not `conversion`. This mixes the custom conversion event with predefined events like `search`, `view-item` etc.",
+"type": "string"
+},
 "dataStore": {
 "description": "The DataStore resource full name, of the form `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. Optional. Only required for user events whose data store can't by determined by UserEvent.engine or UserEvent.documents. If data store is set in the parent of write/import/collect user event requests, this field can be omitted.",
 "type": "string"
@@ -20397,13 +20392,9 @@
 "type": "string"
 },
 "eventType": {
-"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc.",
+"description": "Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home > Men > Jeans * `add-feedback`: Add a user feedback. Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc. Custom conversion value: * `conversion`: Customer defined conversion event.",
 "type": "string"
 },
-"feedback": {
-"$ref": "GoogleCloudDiscoveryengineV1betaFeedback",
-"description": "Optional. This field is optional except for the `add-feedback` event types."
-},
 "filter": {
 "description": "The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendRequest, this field may be populated directly from RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.",
 "type": "string"

googleapiclient/discovery_cache/documents/displayvideo.v2.json

@@ -9267,7 +9267,7 @@
 }
 }
 },
-"revision": "20241031",
+"revision": "20241114",
 "rootUrl": "https://displayvideo.googleapis.com/",
 "schemas": {
 "ActivateManualTriggerRequest": {
@@ -12367,7 +12367,7 @@ false
 "SDF version 6",
 "SDF version 7. Read the [v7 migration guide](/display-video/api/structured-data-file/v7-migration-guide) before migrating to this version.",
 "SDF version 7.1. Read the [v7 migration guide](/display-video/api/structured-data-file/v7-migration-guide) before migrating to this version.",
-"SDF version 8. **This SDF version is in beta. It is only available to a subset of users.**"
+"SDF version 8. Read the [v8 migration guide](/display-video/api/structured-data-file/v8-migration-guide) before migrating to this version."
 ],
 "type": "string"
 }
@@ -16208,7 +16208,7 @@ true
 },
 "pacing": {
 "$ref": "Pacing",
-"description": "Required. The budget spending speed setting of the insertion order. *Warning*: Starting on **November 5, 2024**, pacing_type `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT`. [Read more about this announced change](/display-video/api/deprecations#features.io_asap)."
+"description": "Required. The budget spending speed setting of the insertion order. pacing_type `PACING_TYPE_ASAP` is not compatible with pacing_period `PACING_PERIOD_FLIGHT`."
 },
 "partnerCosts": {
 "description": "The partner costs associated with the insertion order. If absent or empty in CreateInsertionOrder method, the newly created insertion order will inherit partner costs from the partner settings.",
@@ -18862,7 +18862,7 @@ true
 "type": "string"
 },
 "pacingType": {
-"description": "Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. *Warning*: Starting on **November 5, 2024**, `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT` for insertion orders. [Read more about this announced change](/display-video/api/deprecations#features.io_asap).",
+"description": "Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. `PACING_TYPE_ASAP` is not compatible with pacing_period `PACING_PERIOD_FLIGHT` for insertion orders.",
 "enum": [
 "PACING_TYPE_UNSPECIFIED",
 "PACING_TYPE_AHEAD",
@@ -19899,7 +19899,7 @@ false
 "SDF version 6",
 "SDF version 7. Read the [v7 migration guide](/display-video/api/structured-data-file/v7-migration-guide) before migrating to this version.",
 "SDF version 7.1. Read the [v7 migration guide](/display-video/api/structured-data-file/v7-migration-guide) before migrating to this version.",
-"SDF version 8. **This SDF version is in beta. It is only available to a subset of users.**"
+"SDF version 8. Read the [v8 migration guide](/display-video/api/structured-data-file/v8-migration-guide) before migrating to this version."
 ],
 "type": "string"
 }
@@ -19982,7 +19982,7 @@ false
 "SDF version 6",
 "SDF version 7. Read the [v7 migration guide](/display-video/api/structured-data-file/v7-migration-guide) before migrating to this version.",
 "SDF version 7.1. Read the [v7 migration guide](/display-video/api/structured-data-file/v7-migration-guide) before migrating to this version.",
-"SDF version 8. **This SDF version is in beta. It is only available to a subset of users.**"
+"SDF version 8. Read the [v8 migration guide](/display-video/api/structured-data-file/v8-migration-guide) before migrating to this version."
 ],
 "type": "string"
 }