Skip to content

Commit 5b9e25b

Browse files
yoshi-automationsofisl
authored andcommitted
feat(firestore): update the API
#### firestore:v1beta1 The following keys were added: - schemas.FindNearest.properties.distanceResultField.description - schemas.FindNearest.properties.distanceResultField.type - schemas.FindNearest.properties.distanceThreshold.description - schemas.FindNearest.properties.distanceThreshold.format - schemas.FindNearest.properties.distanceThreshold.type The following keys were changed: - schemas.GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata.properties.collectionIds.description - schemas.GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata.properties.namespaceIds.description #### firestore:v1beta2 The following keys were changed: - schemas.GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata.properties.collectionIds.description - schemas.GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata.properties.namespaceIds.description #### firestore:v1 The following keys were added: - schemas.FindNearest.properties.distanceResultField.description - schemas.FindNearest.properties.distanceResultField.type - schemas.FindNearest.properties.distanceThreshold.description - schemas.FindNearest.properties.distanceThreshold.format - schemas.FindNearest.properties.distanceThreshold.type The following keys were changed: - resources.projects.resources.databases.methods.create.parameters.databaseId.description - schemas.GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata.properties.collectionIds.description - schemas.GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata.properties.namespaceIds.description - schemas.GoogleFirestoreAdminV1Database.properties.keyPrefix.description - schemas.GoogleFirestoreAdminV1EncryptionConfig.description - schemas.GoogleFirestoreAdminV1ExportDocumentsMetadata.properties.collectionIds.description - schemas.GoogleFirestoreAdminV1ExportDocumentsMetadata.properties.namespaceIds.description - schemas.GoogleFirestoreAdminV1ExportDocumentsRequest.properties.collectionIds.description - schemas.GoogleFirestoreAdminV1Field.description - schemas.GoogleFirestoreAdminV1ImportDocumentsMetadata.properties.collectionIds.description - schemas.GoogleFirestoreAdminV1ImportDocumentsMetadata.properties.namespaceIds.description - schemas.GoogleFirestoreAdminV1ImportDocumentsRequest.properties.collectionIds.description - schemas.GoogleFirestoreAdminV1Index.properties.queryScope.description - schemas.GoogleFirestoreAdminV1Index.properties.queryScope.enumDescriptions - schemas.GoogleFirestoreAdminV1RestoreDatabaseRequest.properties.backup.description - schemas.GoogleFirestoreAdminV1RestoreDatabaseRequest.properties.databaseId.description
1 parent e0820ea commit 5b9e25b

File tree

6 files changed

+77
-43
lines changed

6 files changed

+77
-43
lines changed

discovery/firestore-v1.json

Lines changed: 27 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,7 @@
151151
],
152152
"parameters": {
153153
"databaseId": {
154-
"description": "Required. The ID to use for the database, which will become the final component of the database's resource name. This value should be 4-63 characters. Valid characters are /a-z-/ with first character a letter and the last a letter or a number. Must not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. \"(default)\" database id is also valid.",
154+
"description": "Required. The ID to use for the database, which will become the final component of the database's resource name. This value should be 4-63 characters. Valid characters are /a-z-/ with first character a letter and the last a letter or a number. Must not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. \"(default)\" database ID is also valid.",
155155
"location": "query",
156156
"type": "string"
157157
},
@@ -1706,7 +1706,7 @@
17061706
}
17071707
}
17081708
},
1709-
"revision": "20240804",
1709+
"revision": "20240822",
17101710
"rootUrl": "https://firestore.googleapis.com/",
17111711
"schemas": {
17121712
"Aggregation": {
@@ -2407,6 +2407,15 @@
24072407
],
24082408
"type": "string"
24092409
},
2410+
"distanceResultField": {
2411+
"description": "Optional. Optional name of the field to output the result of the vector distance calculation. Must conform to document field name limitations.",
2412+
"type": "string"
2413+
},
2414+
"distanceThreshold": {
2415+
"description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold For DOT_PRODUCT: WHERE distance >= distance_threshold",
2416+
"format": "double",
2417+
"type": "number"
2418+
},
24102419
"limit": {
24112420
"description": "Required. The number of nearest neighbors to return. Must be a positive integer of no more than 1000.",
24122421
"format": "int32",
@@ -2521,7 +2530,7 @@
25212530
"id": "GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata",
25222531
"properties": {
25232532
"collectionIds": {
2524-
"description": "The ids of the collection groups that are being deleted.",
2533+
"description": "The IDs of the collection groups that are being deleted.",
25252534
"items": {
25262535
"type": "string"
25272536
},
@@ -2533,7 +2542,7 @@
25332542
"type": "string"
25342543
},
25352544
"namespaceIds": {
2536-
"description": "Which namespace ids are being deleted.",
2545+
"description": "Which namespace IDs are being deleted.",
25372546
"items": {
25382547
"type": "string"
25392548
},
@@ -2722,7 +2731,7 @@
27222731
"type": "string"
27232732
},
27242733
"keyPrefix": {
2725-
"description": "Output only. The key_prefix for this database. This key_prefix is used, in combination with the project id (\"~\") to construct the application id that is returned from the Cloud Datastore APIs in Google App Engine first generation runtimes. This value may be empty in which case the appid to use for URL-encoded keys is the project_id (eg: foo instead of v~foo).",
2734+
"description": "Output only. The key_prefix for this database. This key_prefix is used, in combination with the project ID (\"~\") to construct the application ID that is returned from the Cloud Datastore APIs in Google App Engine first generation runtimes. This value may be empty in which case the appid to use for URL-encoded keys is the project_id (eg: foo instead of v~foo).",
27262735
"readOnly": true,
27272736
"type": "string"
27282737
},
@@ -2794,7 +2803,7 @@
27942803
"type": "object"
27952804
},
27962805
"GoogleFirestoreAdminV1EncryptionConfig": {
2797-
"description": "Encryption configuration for a new database being created from another source. The source could be a Backup or a DatabaseSnapshot.",
2806+
"description": "Encryption configuration for a new database being created from another source. The source could be a Backup .",
27982807
"id": "GoogleFirestoreAdminV1EncryptionConfig",
27992808
"properties": {
28002809
"customerManagedEncryption": {
@@ -2817,7 +2826,7 @@
28172826
"id": "GoogleFirestoreAdminV1ExportDocumentsMetadata",
28182827
"properties": {
28192828
"collectionIds": {
2820-
"description": "Which collection ids are being exported.",
2829+
"description": "Which collection IDs are being exported.",
28212830
"items": {
28222831
"type": "string"
28232832
},
@@ -2829,7 +2838,7 @@
28292838
"type": "string"
28302839
},
28312840
"namespaceIds": {
2832-
"description": "Which namespace ids are being exported.",
2841+
"description": "Which namespace IDs are being exported.",
28332842
"items": {
28342843
"type": "string"
28352844
},
@@ -2889,7 +2898,7 @@
28892898
"id": "GoogleFirestoreAdminV1ExportDocumentsRequest",
28902899
"properties": {
28912900
"collectionIds": {
2892-
"description": "Which collection ids to export. Unspecified means all collections. Each collection id in this list must be unique.",
2901+
"description": "Which collection IDs to export. Unspecified means all collections. Each collection ID in this list must be unique.",
28932902
"items": {
28942903
"type": "string"
28952904
},
@@ -2926,7 +2935,7 @@
29262935
"type": "object"
29272936
},
29282937
"GoogleFirestoreAdminV1Field": {
2929-
"description": "Represents a single field in the database. Fields are grouped by their \"Collection Group\", which represent all collections in the database with the same id.",
2938+
"description": "Represents a single field in the database. Fields are grouped by their \"Collection Group\", which represent all collections in the database with the same ID.",
29302939
"id": "GoogleFirestoreAdminV1Field",
29312940
"properties": {
29322941
"indexConfig": {
@@ -3025,7 +3034,7 @@
30253034
"id": "GoogleFirestoreAdminV1ImportDocumentsMetadata",
30263035
"properties": {
30273036
"collectionIds": {
3028-
"description": "Which collection ids are being imported.",
3037+
"description": "Which collection IDs are being imported.",
30293038
"items": {
30303039
"type": "string"
30313040
},
@@ -3041,7 +3050,7 @@
30413050
"type": "string"
30423051
},
30433052
"namespaceIds": {
3044-
"description": "Which namespace ids are being imported.",
3053+
"description": "Which namespace IDs are being imported.",
30453054
"items": {
30463055
"type": "string"
30473056
},
@@ -3092,7 +3101,7 @@
30923101
"id": "GoogleFirestoreAdminV1ImportDocumentsRequest",
30933102
"properties": {
30943103
"collectionIds": {
3095-
"description": "Which collection ids to import. Unspecified means all collections included in the import. Each collection id in this list must be unique.",
3104+
"description": "Which collection IDs to import. Unspecified means all collections included in the import. Each collection ID in this list must be unique.",
30963105
"items": {
30973106
"type": "string"
30983107
},
@@ -3140,7 +3149,7 @@
31403149
"type": "string"
31413150
},
31423151
"queryScope": {
3143-
"description": "Indexes with a collection query scope specified allow queries against a collection that is the child of a specific document, specified at query time, and that has the same collection id. Indexes with a collection group query scope specified allow queries against all collections descended from a specific document, specified at query time, and that have the same collection id as this index.",
3152+
"description": "Indexes with a collection query scope specified allow queries against a collection that is the child of a specific document, specified at query time, and that has the same collection ID. Indexes with a collection group query scope specified allow queries against all collections descended from a specific document, specified at query time, and that have the same collection ID as this index.",
31443153
"enum": [
31453154
"QUERY_SCOPE_UNSPECIFIED",
31463155
"COLLECTION",
@@ -3149,8 +3158,8 @@
31493158
],
31503159
"enumDescriptions": [
31513160
"The query scope is unspecified. Not a valid option.",
3152-
"Indexes with a collection query scope specified allow queries against a collection that is the child of a specific document, specified at query time, and that has the collection id specified by the index.",
3153-
"Indexes with a collection group query scope specified allow queries against all collections that has the collection id specified by the index.",
3161+
"Indexes with a collection query scope specified allow queries against a collection that is the child of a specific document, specified at query time, and that has the collection ID specified by the index.",
3162+
"Indexes with a collection group query scope specified allow queries against all collections that has the collection ID specified by the index.",
31543163
"Include all the collections's ancestor in the index. Only available for Datastore Mode databases."
31553164
],
31563165
"type": "string"
@@ -3492,11 +3501,11 @@
34923501
"id": "GoogleFirestoreAdminV1RestoreDatabaseRequest",
34933502
"properties": {
34943503
"backup": {
3495-
"description": "Backup to restore from. Must be from the same project as the parent. The restored database will be created in the same location as the source backup. Format is: `projects/{project_id}/locations/{location}/backups/{backup}`",
3504+
"description": "Required. Backup to restore from. Must be from the same project as the parent. The restored database will be created in the same location as the source backup. Format is: `projects/{project_id}/locations/{location}/backups/{backup}`",
34963505
"type": "string"
34973506
},
34983507
"databaseId": {
3499-
"description": "Required. The ID to use for the database, which will become the final component of the database's resource name. This database id must not be associated with an existing database. This value should be 4-63 characters. Valid characters are /a-z-/ with first character a letter and the last a letter or a number. Must not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. \"(default)\" database id is also valid.",
3508+
"description": "Required. The ID to use for the database, which will become the final component of the database's resource name. This database ID must not be associated with an existing database. This value should be 4-63 characters. Valid characters are /a-z-/ with first character a letter and the last a letter or a number. Must not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. \"(default)\" database ID is also valid.",
35003509
"type": "string"
35013510
},
35023511
"encryptionConfig": {

discovery/firestore-v1beta1.json

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -950,7 +950,7 @@
950950
}
951951
}
952952
},
953-
"revision": "20240804",
953+
"revision": "20240822",
954954
"rootUrl": "https://firestore.googleapis.com/",
955955
"schemas": {
956956
"Aggregation": {
@@ -1651,6 +1651,15 @@
16511651
],
16521652
"type": "string"
16531653
},
1654+
"distanceResultField": {
1655+
"description": "Optional. Optional name of the field to output the result of the vector distance calculation. Must conform to document field name limitations.",
1656+
"type": "string"
1657+
},
1658+
"distanceThreshold": {
1659+
"description": "Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified `distance_measure` will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold For DOT_PRODUCT: WHERE distance >= distance_threshold",
1660+
"format": "double",
1661+
"type": "number"
1662+
},
16541663
"limit": {
16551664
"description": "Required. The number of nearest neighbors to return. Must be a positive integer of no more than 1000.",
16561665
"format": "int32",
@@ -1672,7 +1681,7 @@
16721681
"id": "GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata",
16731682
"properties": {
16741683
"collectionIds": {
1675-
"description": "The ids of the collection groups that are being deleted.",
1684+
"description": "The IDs of the collection groups that are being deleted.",
16761685
"items": {
16771686
"type": "string"
16781687
},
@@ -1684,7 +1693,7 @@
16841693
"type": "string"
16851694
},
16861695
"namespaceIds": {
1687-
"description": "Which namespace ids are being deleted.",
1696+
"description": "Which namespace IDs are being deleted.",
16881697
"items": {
16891698
"type": "string"
16901699
},

discovery/firestore-v1beta2.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -415,7 +415,7 @@
415415
}
416416
}
417417
},
418-
"revision": "20240617",
418+
"revision": "20240822",
419419
"rootUrl": "https://firestore.googleapis.com/",
420420
"schemas": {
421421
"Empty": {
@@ -429,7 +429,7 @@
429429
"id": "GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata",
430430
"properties": {
431431
"collectionIds": {
432-
"description": "The ids of the collection groups that are being deleted.",
432+
"description": "The IDs of the collection groups that are being deleted.",
433433
"items": {
434434
"type": "string"
435435
},
@@ -441,7 +441,7 @@
441441
"type": "string"
442442
},
443443
"namespaceIds": {
444-
"description": "Which namespace ids are being deleted.",
444+
"description": "Which namespace IDs are being deleted.",
445445
"items": {
446446
"type": "string"
447447
},

0 commit comments

Comments
 (0)