google-api-python-client 2.147.0__py2.py3-none-any.whl → 2.149.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json

@@ -6709,15 +6709,15 @@
 }
 }
 },
-"identity_mapping_stores": {
+"identityMappingStores": {
 "resources": {
 "operations": {
 "methods": {
 "get": {
 "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/identity_mapping_stores/{identity_mapping_storesId}/operations/{operationsId}",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/identityMappingStores/{identityMappingStoresId}/operations/{operationsId}",
 "httpMethod": "GET",
-"id": "discoveryengine.projects.locations.identity_mapping_stores.operations.get",
+"id": "discoveryengine.projects.locations.identityMappingStores.operations.get",
 "parameterOrder": [
 "name"
 ],
@@ -6725,7 +6725,7 @@
 "name": {
 "description": "The name of the operation resource.",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/identity_mapping_stores/[^/]+/operations/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/identityMappingStores/[^/]+/operations/[^/]+$",
 "required": true,
 "type": "string"
 }
@@ -6740,9 +6740,9 @@
 },
 "list": {
 "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/identity_mapping_stores/{identity_mapping_storesId}/operations",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/identityMappingStores/{identityMappingStoresId}/operations",
 "httpMethod": "GET",
-"id": "discoveryengine.projects.locations.identity_mapping_stores.operations.list",
+"id": "discoveryengine.projects.locations.identityMappingStores.operations.list",
 "parameterOrder": [
 "name"
 ],
@@ -6755,7 +6755,7 @@
 "name": {
 "description": "The name of the operation's parent resource.",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/identity_mapping_stores/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/identityMappingStores/[^/]+$",
 "required": true,
 "type": "string"
 },
@@ -7517,7 +7517,7 @@
 }
 }
 },
-"revision": "20240912",
+"revision": "20240930",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -8149,6 +8149,11 @@
 "description": "DataStore captures global settings and configs at the DataStore level.",
 "id": "GoogleCloudDiscoveryengineV1DataStore",
 "properties": {
+"billingEstimation": {
+"$ref": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation",
+"description": "Output only. Data size estimation for billing.",
+"readOnly": true
+},
 "contentConfig": {
 "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.",
 "enum": [
@@ -8242,6 +8247,43 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1DataStoreBillingEstimation": {
+"description": "Estimation of data size per data store.",
+"id": "GoogleCloudDiscoveryengineV1DataStoreBillingEstimation",
+"properties": {
+"structuredDataSize": {
+"description": "Data size for structured data in terms of bytes.",
+"format": "int64",
+"type": "string"
+},
+"structuredDataUpdateTime": {
+"description": "Last updated timestamp for structured data.",
+"format": "google-datetime",
+"type": "string"
+},
+"unstructuredDataSize": {
+"description": "Data size for unstructured data in terms of bytes.",
+"format": "int64",
+"type": "string"
+},
+"unstructuredDataUpdateTime": {
+"description": "Last updated timestamp for unstructured data.",
+"format": "google-datetime",
+"type": "string"
+},
+"websiteDataSize": {
+"description": "Data size for websites in terms of bytes.",
+"format": "int64",
+"type": "string"
+},
+"websiteDataUpdateTime": {
+"description": "Last updated timestamp for websites.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata": {
 "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata",
@@ -8489,6 +8531,10 @@
 },
 "type": "array"
 },
+"disableAnalytics": {
+"description": "Optional. Whether to disable analytics for searches performed on this engine.",
+"type": "boolean"
+},
 "displayName": {
 "description": "Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.",
 "type": "string"
@@ -9300,6 +9346,14 @@
 "description": "Obfuscated Dasher customer ID.",
 "type": "string"
 },
+"superAdminEmailAddress": {
+"description": "Optional. The super admin email address for the workspace that will be used for access token generation. For now we only use it for Native Google Drive connector data ingestion.",
+"type": "string"
+},
+"superAdminServiceAccount": {
+"description": "Optional. The super admin service account for the workspace that will be used for access token generation. For now we only use it for Native Google Drive connector data ingestion.",
+"type": "string"
+},
 "type": {
 "description": "The Google Workspace data source.",
 "enum": [
@@ -9748,6 +9802,10 @@
 "format": "int32",
 "type": "integer"
 },
+"naturalLanguageQueryUnderstandingSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec",
+"description": "Optional. Specification to enable natural language understanding capabilities for search requests."
+},
 "orderBy": {
 "description": "The order in which documents are returned. Documents can be ordered by a field in an Document object. Leave it unset if ordered by relevance. `order_by` expression is case-sensitive. For more information on ordering, see [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order) If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.",
 "type": "string"
@@ -11487,6 +11545,10 @@
 "description": "The display name of the model.",
 "type": "string"
 },
+"errorMessage": {
+"description": "Currently this is only populated if the model state is `INPUT_VALIDATION_FAILED`.",
+"type": "string"
+},
 "metrics": {
 "additionalProperties": {
 "format": "double",
@@ -11544,6 +11606,11 @@
 "description": "Immutable. Whether data in the DataStore has ACL information. If set to `true`, the source data must have ACL. ACL will be ingested when data is ingested by DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore, Document can't be accessed by calling DocumentService.GetDocument or DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC` industry vertical with non-`PUBLIC_WEBSITE` content config.",
 "type": "boolean"
 },
+"billingEstimation": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation",
+"description": "Output only. Data size estimation for billing.",
+"readOnly": true
+},
 "contentConfig": {
 "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.",
 "enum": [
@@ -11650,6 +11717,43 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation": {
+"description": "Estimation of data size per data store.",
+"id": "GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation",
+"properties": {
+"structuredDataSize": {
+"description": "Data size for structured data in terms of bytes.",
+"format": "int64",
+"type": "string"
+},
+"structuredDataUpdateTime": {
+"description": "Last updated timestamp for structured data.",
+"format": "google-datetime",
+"type": "string"
+},
+"unstructuredDataSize": {
+"description": "Data size for unstructured data in terms of bytes.",
+"format": "int64",
+"type": "string"
+},
+"unstructuredDataUpdateTime": {
+"description": "Last updated timestamp for unstructured data.",
+"format": "google-datetime",
+"type": "string"
+},
+"websiteDataSize": {
+"description": "Data size for websites in terms of bytes.",
+"format": "int64",
+"type": "string"
+},
+"websiteDataUpdateTime": {
+"description": "Last updated timestamp for websites.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata": {
 "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata",
@@ -12105,6 +12209,10 @@
 },
 "type": "array"
 },
+"disableAnalytics": {
+"description": "Optional. Whether to disable analytics for searches performed on this engine.",
+"type": "boolean"
+},
 "displayName": {
 "description": "Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.",
 "type": "string"
@@ -12729,6 +12837,10 @@
 "readOnly": true,
 "type": "string"
 },
+"metatagName": {
+"description": "Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.",
+"type": "string"
+},
 "recsFilterableOption": {
 "description": "If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.",
 "enum": [
@@ -14971,6 +15083,10 @@
 "description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: \"au\"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1`",
 "type": "object"
 },
+"personalizationSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec",
+"description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec."
+},
 "query": {
 "description": "Raw search query.",
 "type": "string"
@@ -15325,6 +15441,10 @@
 "dataStore": {
 "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.",
 "type": "string"
+},
+"filter": {
+"description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)",
+"type": "string"
 }
 },
 "type": "object"
@@ -15475,6 +15595,27 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec": {
+"description": "The specification for personalization.",
+"id": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec",
+"properties": {
+"mode": {
+"description": "The personalization mode of the search request. Defaults to Mode.AUTO.",
+"enum": [
+"MODE_UNSPECIFIED",
+"AUTO",
+"DISABLED"
+],
+"enumDescriptions": [
+"Default value. In this case, server behavior defaults to Mode.AUTO.",
+"Personalization is enabled if data quality requirements are met.",
+"Disable personalization."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec": {
 "description": "Specification to determine under which conditions query expansion should occur.",
 "id": "GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec",
@@ -16265,6 +16406,10 @@
 },
 "type": "array"
 },
+"personalizationSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec",
+"description": "The specification for personalization spec. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec."
+},
 "rankingExpression": {
 "description": "The ranking expression controls the customized ranking on retrieval documents. To leverage this, document embedding is required. The ranking expression setting in ServingConfig applies to all search requests served by the serving config. However, if SearchRequest.ranking_expression is specified, it overrides the ServingConfig ranking expression. The ranking expression is 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)`.",
 "type": "string"
@@ -16999,6 +17144,14 @@
 "description": "Obfuscated Dasher customer ID.",
 "type": "string"
 },
+"superAdminEmailAddress": {
+"description": "Optional. The super admin email address for the workspace that will be used for access token generation. For now we only use it for Native Google Drive connector data ingestion.",
+"type": "string"
+},
+"superAdminServiceAccount": {
+"description": "Optional. The super admin service account for the workspace that will be used for access token generation. For now we only use it for Native Google Drive connector data ingestion.",
+"type": "string"
+},
 "type": {
 "description": "The Google Workspace data source.",
 "enum": [
@@ -17339,6 +17492,10 @@
 "description": "The display name of the model.",
 "type": "string"
 },
+"errorMessage": {
+"description": "Currently this is only populated if the model state is `INPUT_VALIDATION_FAILED`.",
+"type": "string"
+},
 "metrics": {
 "additionalProperties": {
 "format": "double",
@@ -17392,6 +17549,11 @@
 "description": "DataStore captures global settings and configs at the DataStore level.",
 "id": "GoogleCloudDiscoveryengineV1betaDataStore",
 "properties": {
+"billingEstimation": {
+"$ref": "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation",
+"description": "Output only. Data size estimation for billing.",
+"readOnly": true
+},
 "contentConfig": {
 "description": "Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT.",
 "enum": [
@@ -17493,6 +17655,43 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation": {
+"description": "Estimation of data size per data store.",
+"id": "GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation",
+"properties": {
+"structuredDataSize": {
+"description": "Data size for structured data in terms of bytes.",
+"format": "int64",
+"type": "string"
+},
+"structuredDataUpdateTime": {
+"description": "Last updated timestamp for structured data.",
+"format": "google-datetime",
+"type": "string"
+},
+"unstructuredDataSize": {
+"description": "Data size for unstructured data in terms of bytes.",
+"format": "int64",
+"type": "string"
+},
+"unstructuredDataUpdateTime": {
+"description": "Last updated timestamp for unstructured data.",
+"format": "google-datetime",
+"type": "string"
+},
+"websiteDataSize": {
+"description": "Data size for websites in terms of bytes.",
+"format": "int64",
+"type": "string"
+},
+"websiteDataUpdateTime": {
+"description": "Last updated timestamp for websites.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata": {
 "description": "Metadata related to the progress of the DataStoreService.DeleteDataStore operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata",
@@ -17740,6 +17939,10 @@
 },
 "type": "array"
 },
+"disableAnalytics": {
+"description": "Optional. Whether to disable analytics for searches performed on this engine.",
+"type": "boolean"
+},
 "displayName": {
 "description": "Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.",
 "type": "string"
@@ -18643,6 +18846,10 @@
 "description": "Additional search parameters. For public website search only, supported values are: * `user_country_code`: string. Default empty. If set to non-empty, results are restricted or boosted based on the location provided. For example, `user_country_code: \"au\"` For available codes see [Country Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes) * `search_type`: double. Default empty. Enables non-webpage searching depending on the value. The only valid non-default value is 1, which enables image searching. For example, `search_type: 1`",
 "type": "object"
 },
+"personalizationSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec",
+"description": "The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec."
+},
 "query": {
 "description": "Raw search query.",
 "type": "string"
@@ -18997,6 +19204,10 @@
 "dataStore": {
 "description": "Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`.",
 "type": "string"
+},
+"filter": {
+"description": "Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)",
+"type": "string"
 }
 },
 "type": "object"
@@ -19147,6 +19358,27 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec": {
+"description": "The specification for personalization.",
+"id": "GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec",
+"properties": {
+"mode": {
+"description": "The personalization mode of the search request. Defaults to Mode.AUTO.",
+"enum": [
+"MODE_UNSPECIFIED",
+"AUTO",
+"DISABLED"
+],
+"enumDescriptions": [
+"Default value. In this case, server behavior defaults to Mode.AUTO.",
+"Personalization is enabled if data quality requirements are met.",
+"Disable personalization."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec": {
 "description": "Specification to determine under which conditions query expansion should occur.",
 "id": "GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec",
@@ -19496,6 +19728,14 @@
 "description": "Obfuscated Dasher customer ID.",
 "type": "string"
 },
+"superAdminEmailAddress": {
+"description": "Optional. The super admin email address for the workspace that will be used for access token generation. For now we only use it for Native Google Drive connector data ingestion.",
+"type": "string"
+},
+"superAdminServiceAccount": {
+"description": "Optional. The super admin service account for the workspace that will be used for access token generation. For now we only use it for Native Google Drive connector data ingestion.",
+"type": "string"
+},
 "type": {
 "description": "The Google Workspace data source.",
 "enum": [