@maxim_mazurok/gapi.client.discoveryengine-v1 0.0.20240912 → 0.0.20240930

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/index.d.ts +95 -3
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -9,7 +9,7 @@
9
9
  // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
10
10
  // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
11
11
  // Generated from: https://discoveryengine.googleapis.com/$discovery/rest?version=v1
12
- // Revision: 20240912
12
+ // Revision: 20240930
13
13
 
14
14
  /// <reference types="gapi.client" />
15
15
 
@@ -362,6 +362,8 @@ declare namespace gapi.client {
362
362
  createTime?: string;
363
363
  /** The display name of the model. */
364
364
  displayName?: string;
365
+ /** Currently this is only populated if the model state is `INPUT_VALIDATION_FAILED`. */
366
+ errorMessage?: string;
365
367
  /** The metrics of the trained model. */
366
368
  metrics?: {[P in string]: number};
367
369
  /** The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`). */
@@ -376,6 +378,8 @@ declare namespace gapi.client {
376
378
  interface GoogleCloudDiscoveryengineV1alphaDataStore {
377
379
  /** 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. */
378
380
  aclEnabled?: boolean;
381
+ /** Output only. Data size estimation for billing. */
382
+ billingEstimation?: GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation;
379
383
  /** Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. */
380
384
  contentConfig?: string;
381
385
  /** Output only. Timestamp the DataStore was created at. */
@@ -405,6 +409,20 @@ declare namespace gapi.client {
405
409
  /** 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. */
406
410
  workspaceConfig?: GoogleCloudDiscoveryengineV1alphaWorkspaceConfig;
407
411
  }
412
+ interface GoogleCloudDiscoveryengineV1alphaDataStoreBillingEstimation {
413
+ /** Data size for structured data in terms of bytes. */
414
+ structuredDataSize?: string;
415
+ /** Last updated timestamp for structured data. */
416
+ structuredDataUpdateTime?: string;
417
+ /** Data size for unstructured data in terms of bytes. */
418
+ unstructuredDataSize?: string;
419
+ /** Last updated timestamp for unstructured data. */
420
+ unstructuredDataUpdateTime?: string;
421
+ /** Data size for websites in terms of bytes. */
422
+ websiteDataSize?: string;
423
+ /** Last updated timestamp for websites. */
424
+ websiteDataUpdateTime?: string;
425
+ }
408
426
  interface GoogleCloudDiscoveryengineV1alphaDeleteDataStoreMetadata {
409
427
  /** Operation create time. */
410
428
  createTime?: string;
@@ -492,6 +510,8 @@ declare namespace gapi.client {
492
510
  createTime?: string;
493
511
  /** The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. */
494
512
  dataStoreIds?: string[];
513
+ /** Optional. Whether to disable analytics for searches performed on this engine. */
514
+ disableAnalytics?: boolean;
495
515
  /** Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters. */
496
516
  displayName?: string;
497
517
  /** The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine. */
@@ -621,6 +641,8 @@ declare namespace gapi.client {
621
641
  indexableOption?: string;
622
642
  /** 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. */
623
643
  keyPropertyType?: string;
644
+ /** 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. */
645
+ metatagName?: string;
624
646
  /** 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. */
625
647
  recsFilterableOption?: string;
626
648
  /** 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 +972,8 @@ declare namespace gapi.client {
950
972
  pageToken?: string;
951
973
  /** 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` */
952
974
  params?: {[P in string]: any};
975
+ /** The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec. */
976
+ personalizationSpec?: GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec;
953
977
  /** Raw search query. */
954
978
  query?: string;
955
979
  /** The query expansion specification that specifies the conditions under which query expansion occurs. */
@@ -1078,6 +1102,8 @@ declare namespace gapi.client {
1078
1102
  interface GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec {
1079
1103
  /** Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. */
1080
1104
  dataStore?: string;
1105
+ /** 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) */
1106
+ filter?: string;
1081
1107
  }
1082
1108
  interface GoogleCloudDiscoveryengineV1alphaSearchRequestEmbeddingSpec {
1083
1109
  /** The embedding vector used for retrieval. Limit to 1. */
@@ -1125,6 +1151,10 @@ declare namespace gapi.client {
1125
1151
  /** 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. */
1126
1152
  geoSearchQueryDetectionFieldNames?: string[];
1127
1153
  }
1154
+ interface GoogleCloudDiscoveryengineV1alphaSearchRequestPersonalizationSpec {
1155
+ /** The personalization mode of the search request. Defaults to Mode.AUTO. */
1156
+ mode?: string;
1157
+ }
1128
1158
  interface GoogleCloudDiscoveryengineV1alphaSearchRequestQueryExpansionSpec {
1129
1159
  /** The condition under which query expansion should occur. Default to Condition.DISABLED. */
1130
1160
  condition?: string;
@@ -1256,6 +1286,10 @@ declare namespace gapi.client {
1256
1286
  interface GoogleCloudDiscoveryengineV1alphaWorkspaceConfig {
1257
1287
  /** Obfuscated Dasher customer ID. */
1258
1288
  dasherCustomerId?: string;
1289
+ /** 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. */
1290
+ superAdminEmailAddress?: string;
1291
+ /** 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. */
1292
+ superAdminServiceAccount?: string;
1259
1293
  /** The Google Workspace data source. */
1260
1294
  type?: string;
1261
1295
  }
@@ -1706,6 +1740,8 @@ declare namespace gapi.client {
1706
1740
  createTime?: string;
1707
1741
  /** The display name of the model. */
1708
1742
  displayName?: string;
1743
+ /** Currently this is only populated if the model state is `INPUT_VALIDATION_FAILED`. */
1744
+ errorMessage?: string;
1709
1745
  /** The metrics of the trained model. */
1710
1746
  metrics?: {[P in string]: number};
1711
1747
  /** The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`). */
@@ -1718,6 +1754,8 @@ declare namespace gapi.client {
1718
1754
  trainingStartTime?: string;
1719
1755
  }
1720
1756
  interface GoogleCloudDiscoveryengineV1betaDataStore {
1757
+ /** Output only. Data size estimation for billing. */
1758
+ billingEstimation?: GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation;
1721
1759
  /** Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. */
1722
1760
  contentConfig?: string;
1723
1761
  /** Output only. Timestamp the DataStore was created at. */
@@ -1745,6 +1783,20 @@ declare namespace gapi.client {
1745
1783
  /** 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. */
1746
1784
  workspaceConfig?: GoogleCloudDiscoveryengineV1betaWorkspaceConfig;
1747
1785
  }
1786
+ interface GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation {
1787
+ /** Data size for structured data in terms of bytes. */
1788
+ structuredDataSize?: string;
1789
+ /** Last updated timestamp for structured data. */
1790
+ structuredDataUpdateTime?: string;
1791
+ /** Data size for unstructured data in terms of bytes. */
1792
+ unstructuredDataSize?: string;
1793
+ /** Last updated timestamp for unstructured data. */
1794
+ unstructuredDataUpdateTime?: string;
1795
+ /** Data size for websites in terms of bytes. */
1796
+ websiteDataSize?: string;
1797
+ /** Last updated timestamp for websites. */
1798
+ websiteDataUpdateTime?: string;
1799
+ }
1748
1800
  interface GoogleCloudDiscoveryengineV1betaDeleteDataStoreMetadata {
1749
1801
  /** Operation create time. */
1750
1802
  createTime?: string;
@@ -1832,6 +1884,8 @@ declare namespace gapi.client {
1832
1884
  createTime?: string;
1833
1885
  /** The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. */
1834
1886
  dataStoreIds?: string[];
1887
+ /** Optional. Whether to disable analytics for searches performed on this engine. */
1888
+ disableAnalytics?: boolean;
1835
1889
  /** Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters. */
1836
1890
  displayName?: string;
1837
1891
  /** The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine. */
@@ -2139,6 +2193,8 @@ declare namespace gapi.client {
2139
2193
  pageToken?: string;
2140
2194
  /** 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` */
2141
2195
  params?: {[P in string]: any};
2196
+ /** The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set, SearchRequest.personalization_spec overrides ServingConfig.personalization_spec. */
2197
+ personalizationSpec?: GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec;
2142
2198
  /** Raw search query. */
2143
2199
  query?: string;
2144
2200
  /** The query expansion specification that specifies the conditions under which query expansion occurs. */
@@ -2267,6 +2323,8 @@ declare namespace gapi.client {
2267
2323
  interface GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec {
2268
2324
  /** Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. */
2269
2325
  dataStore?: string;
2326
+ /** 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) */
2327
+ filter?: string;
2270
2328
  }
2271
2329
  interface GoogleCloudDiscoveryengineV1betaSearchRequestEmbeddingSpec {
2272
2330
  /** The embedding vector used for retrieval. Limit to 1. */
@@ -2314,6 +2372,10 @@ declare namespace gapi.client {
2314
2372
  /** 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. */
2315
2373
  geoSearchQueryDetectionFieldNames?: string[];
2316
2374
  }
2375
+ interface GoogleCloudDiscoveryengineV1betaSearchRequestPersonalizationSpec {
2376
+ /** The personalization mode of the search request. Defaults to Mode.AUTO. */
2377
+ mode?: string;
2378
+ }
2317
2379
  interface GoogleCloudDiscoveryengineV1betaSearchRequestQueryExpansionSpec {
2318
2380
  /** The condition under which query expansion should occur. Default to Condition.DISABLED. */
2319
2381
  condition?: string;
@@ -2418,6 +2480,10 @@ declare namespace gapi.client {
2418
2480
  interface GoogleCloudDiscoveryengineV1betaWorkspaceConfig {
2419
2481
  /** Obfuscated Dasher customer ID. */
2420
2482
  dasherCustomerId?: string;
2483
+ /** 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. */
2484
+ superAdminEmailAddress?: string;
2485
+ /** 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. */
2486
+ superAdminServiceAccount?: string;
2421
2487
  /** The Google Workspace data source. */
2422
2488
  type?: string;
2423
2489
  }
@@ -2750,6 +2816,8 @@ declare namespace gapi.client {
2750
2816
  createTime?: string;
2751
2817
  /** The display name of the model. */
2752
2818
  displayName?: string;
2819
+ /** Currently this is only populated if the model state is `INPUT_VALIDATION_FAILED`. */
2820
+ errorMessage?: string;
2753
2821
  /** The metrics of the trained model. */
2754
2822
  metrics?: {[P in string]: number};
2755
2823
  /** The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`). */
@@ -2762,6 +2830,8 @@ declare namespace gapi.client {
2762
2830
  trainingStartTime?: string;
2763
2831
  }
2764
2832
  interface GoogleCloudDiscoveryengineV1DataStore {
2833
+ /** Output only. Data size estimation for billing. */
2834
+ billingEstimation?: GoogleCloudDiscoveryengineV1DataStoreBillingEstimation;
2765
2835
  /** Immutable. The content config of the data store. If this field is unset, the server behavior defaults to ContentConfig.NO_CONTENT. */
2766
2836
  contentConfig?: string;
2767
2837
  /** Output only. Timestamp the DataStore was created at. */
@@ -2785,6 +2855,20 @@ declare namespace gapi.client {
2785
2855
  /** 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. */
2786
2856
  workspaceConfig?: GoogleCloudDiscoveryengineV1WorkspaceConfig;
2787
2857
  }
2858
+ interface GoogleCloudDiscoveryengineV1DataStoreBillingEstimation {
2859
+ /** Data size for structured data in terms of bytes. */
2860
+ structuredDataSize?: string;
2861
+ /** Last updated timestamp for structured data. */
2862
+ structuredDataUpdateTime?: string;
2863
+ /** Data size for unstructured data in terms of bytes. */
2864
+ unstructuredDataSize?: string;
2865
+ /** Last updated timestamp for unstructured data. */
2866
+ unstructuredDataUpdateTime?: string;
2867
+ /** Data size for websites in terms of bytes. */
2868
+ websiteDataSize?: string;
2869
+ /** Last updated timestamp for websites. */
2870
+ websiteDataUpdateTime?: string;
2871
+ }
2788
2872
  interface GoogleCloudDiscoveryengineV1DeleteDataStoreMetadata {
2789
2873
  /** Operation create time. */
2790
2874
  createTime?: string;
@@ -2924,6 +3008,8 @@ declare namespace gapi.client {
2924
3008
  createTime?: string;
2925
3009
  /** The data stores associated with this engine. For SOLUTION_TYPE_SEARCH and SOLUTION_TYPE_RECOMMENDATION type of engines, they can only associate with at most one data store. If solution_type is SOLUTION_TYPE_CHAT, multiple DataStores in the same Collection can be associated here. Note that when used in CreateEngineRequest, one DataStore id must be provided as the system will use it for necessary initializations. */
2926
3010
  dataStoreIds?: string[];
3011
+ /** Optional. Whether to disable analytics for searches performed on this engine. */
3012
+ disableAnalytics?: boolean;
2927
3013
  /** Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters. */
2928
3014
  displayName?: string;
2929
3015
  /** The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine. */
@@ -3591,6 +3677,8 @@ declare namespace gapi.client {
3591
3677
  interface GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec {
3592
3678
  /** Required. Full resource name of DataStore, such as `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. */
3593
3679
  dataStore?: string;
3680
+ /** 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) */
3681
+ filter?: string;
3594
3682
  }
3595
3683
  interface GoogleCloudDiscoveryengineV1SearchRequestFacetSpec {
3596
3684
  /** 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. */
@@ -3959,6 +4047,10 @@ declare namespace gapi.client {
3959
4047
  interface GoogleCloudDiscoveryengineV1WorkspaceConfig {
3960
4048
  /** Obfuscated Dasher customer ID. */
3961
4049
  dasherCustomerId?: string;
4050
+ /** 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. */
4051
+ superAdminEmailAddress?: string;
4052
+ /** 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. */
4053
+ superAdminServiceAccount?: string;
3962
4054
  /** The Google Workspace data source. */
3963
4055
  type?: string;
3964
4056
  }
@@ -11608,7 +11700,7 @@ declare namespace gapi.client {
11608
11700
  uploadType?: string;
11609
11701
  }): Request<GoogleLongrunningListOperationsResponse>;
11610
11702
  }
11611
- interface Identity_mapping_storesResource {
11703
+ interface IdentityMappingStoresResource {
11612
11704
  operations: OperationsResource;
11613
11705
  }
11614
11706
  interface OperationsResource {
@@ -11834,7 +11926,7 @@ declare namespace gapi.client {
11834
11926
  collections: CollectionsResource;
11835
11927
  dataStores: DataStoresResource;
11836
11928
  groundingConfigs: GroundingConfigsResource;
11837
- identity_mapping_stores: Identity_mapping_storesResource;
11929
+ identityMappingStores: IdentityMappingStoresResource;
11838
11930
  operations: OperationsResource;
11839
11931
  rankingConfigs: RankingConfigsResource;
11840
11932
  userEvents: UserEventsResource;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@maxim_mazurok/gapi.client.discoveryengine-v1",
3
- "version": "0.0.20240912",
3
+ "version": "0.0.20240930",
4
4
  "description": "TypeScript typings for Discovery Engine API v1",
5
5
  "repository": {
6
6
  "type": "git",