@maxim_mazurok/gapi.client.discoveryengine-v1 0.0.20240906 → 0.0.20240920

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://discoveryengine.googleapis.com/$discovery/rest?version=v1
-// Revision: 20240906
+// Revision: 20240920
 
 /// <reference types="gapi.client" />
 
@@ -376,6 +376,8 @@ declare namespace gapi.client {
     interface GoogleCloudDiscoveryengineV1alphaDataStore {
       /** 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. */
       aclEnabled?: boolean;
+      /** Output only. Data size estimation for billing. */
+      billingEstimation?: GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation;
       /** Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. */
       contentConfig?: string;
       /** Output only. Timestamp the DataStore was created at. */
@@ -405,6 +407,20 @@ declare namespace gapi.client {
       /** Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE. */
       workspaceConfig?: GoogleCloudDiscoveryengineV1alphaWorkspaceConfig;
     }
+    interface GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation {
+      /** Data size for structured data in terms of bytes. */
+      structuredDataSize?: string;
+      /** Last updated timestamp for structured data. */
+      structuredDataUpdateTime?: string;
+      /** Data size for unstructured data in terms of bytes. */
+      unstructuredDataSize?: string;
+      /** Last updated timestamp for unstructured data. */
+      unstructuredDataUpdateTime?: string;
+      /** Data size for websites in terms of bytes. */
+      websiteDataSize?: string;
+      /** Last updated timestamp for websites. */
+      websiteDataUpdateTime?: string;
+    }
     interface GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata {
       /** Operation create time. */
       createTime?: string;
@@ -621,6 +637,8 @@ declare namespace gapi.client {
       indexableOption?: string;
       /** Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified. */
       keyPropertyType?: string;
+      /** 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. */
+      metatagName?: string;
       /** 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. */
       recsFilterableOption?: string;
       /** If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error. */
@@ -950,6 +968,8 @@ declare namespace gapi.client {
       pageToken?: string;
       /** 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` */
       params?: {[P in string]: any};
+      /** The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec. */
+      personalizationSpec?: GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec;
       /** Raw search query. */
       query?: string;
       /** The query expansion specification that specifies the conditions under which query expansion occurs. */
@@ -1078,6 +1098,8 @@ declare namespace gapi.client {
     interface GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec {
       /** Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. */
       dataStore?: string;
+      /** 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) */
+      filter?: string;
     }
     interface GoogleCloudDiscoveryengineV1alphaSearchRequestEmbeddingSpec {
       /** The embedding vector used for retrieval. Limit to 1. */
@@ -1125,6 +1147,10 @@ declare namespace gapi.client {
       /** Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to `ENABLED`. If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names. */
       geoSearchQueryDetectionFieldNames?: string[];
     }
+    interface GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec {
+      /** The personalization mode of the search request. Defaults to Mode.AUTO. */
+      mode?: string;
+    }
     interface GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec {
       /** The condition under which query expansion should occur. Default to Condition.DISABLED. */
       condition?: string;
@@ -1414,9 +1440,9 @@ declare namespace gapi.client {
     interface GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo {
       /** Document resource name. */
       document?: string;
-      /** List of document contexts. */
+      /** List of document contexts. The content will be used for Answer Generation. This is supposed to be the main content of the document that can be long and comprehensive. */
       documentContexts?: GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext[];
-      /** List of extractive answers. */
+      /** Deprecated: This field is deprecated and will have no effect on the Answer generation. Please use document_contexts and extractive_segments fields. List of extractive answers. */
       extractiveAnswers?: GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveAnswer[];
       /** List of extractive segments. */
       extractiveSegments?: GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveSegment[];
@@ -1426,7 +1452,7 @@ declare namespace gapi.client {
       uri?: string;
     }
     interface GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext {
-      /** Document content. */
+      /** Document content to be used for answer generation. */
       content?: string;
       /** Page identifier. */
       pageIdentifier?: string;
@@ -1718,6 +1744,8 @@ declare namespace gapi.client {
       trainingStartTime?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaDataStore {
+      /** Output only. Data size estimation for billing. */
+      billingEstimation?: GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation;
       /** Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. */
       contentConfig?: string;
       /** Output only. Timestamp the DataStore was created at. */
@@ -1745,6 +1773,20 @@ declare namespace gapi.client {
       /** Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE. */
       workspaceConfig?: GoogleCloudDiscoveryengineV1betaWorkspaceConfig;
     }
+    interface GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation {
+      /** Data size for structured data in terms of bytes. */
+      structuredDataSize?: string;
+      /** Last updated timestamp for structured data. */
+      structuredDataUpdateTime?: string;
+      /** Data size for unstructured data in terms of bytes. */
+      unstructuredDataSize?: string;
+      /** Last updated timestamp for unstructured data. */
+      unstructuredDataUpdateTime?: string;
+      /** Data size for websites in terms of bytes. */
+      websiteDataSize?: string;
+      /** Last updated timestamp for websites. */
+      websiteDataUpdateTime?: string;
+    }
     interface GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata {
       /** Operation create time. */
       createTime?: string;
@@ -2139,6 +2181,8 @@ declare namespace gapi.client {
       pageToken?: string;
       /** 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` */
       params?: {[P in string]: any};
+      /** The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec. */
+      personalizationSpec?: GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec;
       /** Raw search query. */
       query?: string;
       /** The query expansion specification that specifies the conditions under which query expansion occurs. */
@@ -2267,6 +2311,8 @@ declare namespace gapi.client {
     interface GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec {
       /** Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. */
       dataStore?: string;
+      /** 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) */
+      filter?: string;
     }
     interface GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec {
       /** The embedding vector used for retrieval. Limit to 1. */
@@ -2314,6 +2360,10 @@ declare namespace gapi.client {
       /** Field names used for location-based filtering, where geolocation filters are detected in natural language search queries. Only valid when the FilterExtractionCondition is set to `ENABLED`. If this field is set, it overrides the field names set in ServingConfig.geo_search_query_detection_field_names. */
       geoSearchQueryDetectionFieldNames?: string[];
     }
+    interface GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec {
+      /** The personalization mode of the search request. Defaults to Mode.AUTO. */
+      mode?: string;
+    }
     interface GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec {
       /** The condition under which query expansion should occur. Default to Condition.DISABLED. */
       condition?: string;
@@ -2762,6 +2812,8 @@ declare namespace gapi.client {
       trainingStartTime?: string;
     }
     interface GoogleCloudDiscoveryengineV1DataStore {
+      /** Output only. Data size estimation for billing. */
+      billingEstimation?: GoogleCloudDiscoveryengineV1DataStoreBillingEstimation;
       /** Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. */
       contentConfig?: string;
       /** Output only. Timestamp the DataStore was created at. */
@@ -2785,6 +2837,20 @@ declare namespace gapi.client {
       /** Config to store data store type configuration for workspace data. This must be set when DataStore.content_config is set as DataStore.ContentConfig.GOOGLE_WORKSPACE. */
       workspaceConfig?: GoogleCloudDiscoveryengineV1WorkspaceConfig;
     }
+    interface GoogleCloudDiscoveryengineV1DataStoreBillingEstimation {
+      /** Data size for structured data in terms of bytes. */
+      structuredDataSize?: string;
+      /** Last updated timestamp for structured data. */
+      structuredDataUpdateTime?: string;
+      /** Data size for unstructured data in terms of bytes. */
+      unstructuredDataSize?: string;
+      /** Last updated timestamp for unstructured data. */
+      unstructuredDataUpdateTime?: string;
+      /** Data size for websites in terms of bytes. */
+      websiteDataSize?: string;
+      /** Last updated timestamp for websites. */
+      websiteDataUpdateTime?: string;
+    }
     interface GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata {
       /** Operation create time. */
       createTime?: string;
@@ -3591,6 +3657,8 @@ declare namespace gapi.client {
     interface GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec {
       /** Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. */
       dataStore?: string;
+      /** 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) */
+      filter?: string;
     }
     interface GoogleCloudDiscoveryengineV1SearchRequestFacetSpec {
       /** Enables dynamic position for this facet. If set to true, the position of this facet among all facets in the response is determined automatically. If dynamic facets are enabled, it is ordered together. If set to false, the position of this facet in the response is the same as in the request, and it is ranked before the facets with dynamic position enable and all dynamic facets. For example, you may always want to have rating facet returned in the response, but it's not necessarily to always display the rating facet at the top. In that case, you can set enable_dynamic_position to true so that the position of rating facet in response is determined automatically. Another example, assuming you have the following facets in the request: * "rating", enable_dynamic_position = true * "price", enable_dynamic_position = false * "brands", enable_dynamic_position = false And also you have a dynamic facets enabled, which generates a facet `gender`. Then the final order of the facets in the response can be ("price", "brands", "rating", "gender") or ("price", "brands", "gender", "rating") depends on how API orders "gender" and "rating" facets. However, notice that "price" and "brands" are always ranked at first and second position because their enable_dynamic_position is false. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.discoveryengine-v1",
-  "version": "0.0.20240906",
+  "version": "0.0.20240920",
   "description": "TypeScript typings for Discovery Engine API v1",
   "repository": {
     "type": "git",