Skip to content

Commit 92a99d6

Browse files
cloud-java-botcloud-java-bot
authored
chore: Update generation configuration at Fri Sep 13 02:22:55 UTC 2024 (#1787)
* chore: Update generation configuration at Tue Aug 13 02:18:20 UTC 2024 * chore: Update generation configuration at Wed Aug 14 02:17:50 UTC 2024 * chore: Update generation configuration at Thu Aug 15 02:14:55 UTC 2024 * chore: Update generation configuration at Fri Aug 16 02:17:34 UTC 2024 * chore: Update generation configuration at Sat Aug 17 02:16:16 UTC 2024 * chore: Update generation configuration at Sun Aug 18 02:18:57 UTC 2024 * chore: generate libraries at Sun Aug 18 02:19:17 UTC 2024 * chore: Update generation configuration at Tue Aug 20 02:17:32 UTC 2024 * chore: Update generation configuration at Wed Aug 21 02:20:11 UTC 2024 * chore: Update generation configuration at Fri Aug 23 02:17:56 UTC 2024 * chore: Update generation configuration at Sat Aug 24 02:17:29 UTC 2024 * chore: Update generation configuration at Tue Aug 27 02:18:49 UTC 2024 * chore: generate libraries at Tue Aug 27 02:19:12 UTC 2024 * chore: Update generation configuration at Wed Aug 28 02:19:26 UTC 2024 * chore: Update generation configuration at Thu Aug 29 02:20:26 UTC 2024 * chore: generate libraries at Thu Aug 29 02:20:48 UTC 2024 * chore: Update generation configuration at Fri Aug 30 02:21:07 UTC 2024 * chore: generate libraries at Fri Aug 30 02:21:27 UTC 2024 * chore: Update generation configuration at Sat Aug 31 02:20:04 UTC 2024 * chore: Update generation configuration at Wed Sep 4 02:21:06 UTC 2024 * chore: Update generation configuration at Thu Sep 5 02:21:40 UTC 2024 * chore: Update generation configuration at Fri Sep 6 02:21:23 UTC 2024 * chore: Update generation configuration at Sat Sep 7 02:19:42 UTC 2024 * chore: generate libraries at Sat Sep 7 02:20:07 UTC 2024 * chore: Update generation configuration at Sun Sep 8 02:25:10 UTC 2024 * chore: Update generation configuration at Tue Sep 10 02:22:35 UTC 2024 * chore: Update generation configuration at Tue Sep 10 19:31:50 UTC 2024 * chore: generate libraries at Tue Sep 10 19:32:15 UTC 2024 * chore: Update generation configuration at Wed Sep 11 02:21:46 UTC 2024 * chore: Update generation configuration at Thu Sep 12 02:22:11 UTC 2024 * chore: Update generation configuration at Fri Sep 13 02:22:55 UTC 2024
1 parent 4a9fa15 commit 92a99d6

249 files changed

Lines changed: 11044 additions & 2322 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎java-firestore/README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,20 +50,20 @@ If you are using Maven without the BOM, add this to your dependencies:
5050
If you are using Gradle 5.x or later, add this to your dependencies:
5151

5252
```Groovy
53-
implementation platform('com.google.cloud:libraries-bom:26.44.0')
53+
implementation platform('com.google.cloud:libraries-bom:26.45.0')
5454
5555
implementation 'com.google.cloud:google-cloud-firestore'
5656
```
5757
If you are using Gradle without BOM, add this to your dependencies:
5858

5959
```Groovy
60-
implementation 'com.google.cloud:google-cloud-firestore:3.24.3'
60+
implementation 'com.google.cloud:google-cloud-firestore:3.25.0'
6161
```
6262

6363
If you are using SBT, add this to your dependencies:
6464

6565
```Scala
66-
libraryDependencies += "com.google.cloud" % "google-cloud-firestore" % "3.24.3"
66+
libraryDependencies += "com.google.cloud" % "google-cloud-firestore" % "3.25.0"
6767
```
6868
<!-- {x-version-update-end} -->
6969

@@ -220,7 +220,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
220220
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-firestore/java11.html
221221
[stability-image]: https://img.shields.io/badge/stability-stable-green
222222
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-firestore.svg
223-
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-firestore/3.24.3
223+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-firestore/3.25.0
224224
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
225225
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
226226
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

‎java-firestore/generation_config.yaml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
gapic_generator_version: 2.43.0
2-
googleapis_commitish: 5b517c2637fa5b4cb8f5323af33e19f31c31b4da
3-
libraries_bom_version: 26.44.0
1+
gapic_generator_version: 2.45.0
2+
googleapis_commitish: 0eb6e43796dbc0212d0b5114c2106a3c6ebd6228
3+
libraries_bom_version: 26.45.0
44
libraries:
55
- api_shortname: firestore
66
name_pretty: Cloud Firestore

‎java-firestore/google-cloud-firestore-admin/src/main/java/com/google/cloud/firestore/v1/FirestoreAdminClient.java‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2350,7 +2350,7 @@ public final UnaryCallable<BulkDeleteDocumentsRequest, Operation> bulkDeleteDocu
23502350
* <p>This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ with first
23512351
* character a letter and the last a letter or a number. Must not be UUID-like
23522352
* /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.
2353-
* <p>"(default)" database id is also valid.
2353+
* <p>"(default)" database ID is also valid.
23542354
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
23552355
*/
23562356
public final OperationFuture<Database, CreateDatabaseMetadata> createDatabaseAsync(
@@ -2392,7 +2392,7 @@ public final OperationFuture<Database, CreateDatabaseMetadata> createDatabaseAsy
23922392
* <p>This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ with first
23932393
* character a letter and the last a letter or a number. Must not be UUID-like
23942394
* /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.
2395-
* <p>"(default)" database id is also valid.
2395+
* <p>"(default)" database ID is also valid.
23962396
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
23972397
*/
23982398
public final OperationFuture<Database, CreateDatabaseMetadata> createDatabaseAsync(
@@ -3349,6 +3349,7 @@ public final UnaryCallable<DeleteBackupRequest, Empty> deleteBackupCallable() {
33493349
* .setParent(ProjectName.of("[PROJECT]").toString())
33503350
* .setDatabaseId("databaseId1688905718")
33513351
* .setBackup(BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString())
3352+
* .setEncryptionConfig(Database.EncryptionConfig.newBuilder().build())
33523353
* .build();
33533354
* Database response = firestoreAdminClient.restoreDatabaseAsync(request).get();
33543355
* }
@@ -3393,6 +3394,7 @@ public final OperationFuture<Database, RestoreDatabaseMetadata> restoreDatabaseA
33933394
* .setParent(ProjectName.of("[PROJECT]").toString())
33943395
* .setDatabaseId("databaseId1688905718")
33953396
* .setBackup(BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString())
3397+
* .setEncryptionConfig(Database.EncryptionConfig.newBuilder().build())
33963398
* .build();
33973399
* OperationFuture<Database, RestoreDatabaseMetadata> future =
33983400
* firestoreAdminClient.restoreDatabaseOperationCallable().futureCall(request);
@@ -3437,6 +3439,7 @@ public final OperationFuture<Database, RestoreDatabaseMetadata> restoreDatabaseA
34373439
* .setParent(ProjectName.of("[PROJECT]").toString())
34383440
* .setDatabaseId("databaseId1688905718")
34393441
* .setBackup(BackupName.of("[PROJECT]", "[LOCATION]", "[BACKUP]").toString())
3442+
* .setEncryptionConfig(Database.EncryptionConfig.newBuilder().build())
34403443
* .build();
34413444
* ApiFuture<Operation> future =
34423445
* firestoreAdminClient.restoreDatabaseCallable().futureCall(request);

‎java-firestore/google-cloud-firestore-admin/src/main/java/com/google/cloud/firestore/v1/FirestoreAdminSettings.java‎

Lines changed: 41 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,9 @@
9999
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
100100
* build() is called, the tree of builders is called to create the complete settings object.
101101
*
102-
* <p>For example, to set the total timeout of getIndex to 30 seconds:
102+
* <p>For example, to set the
103+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
104+
* of getIndex:
103105
*
104106
* <pre>{@code
105107
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -116,10 +118,47 @@
116118
* .getIndexSettings()
117119
* .getRetrySettings()
118120
* .toBuilder()
119-
* .setTotalTimeout(Duration.ofSeconds(30))
121+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
122+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
123+
* .setMaxAttempts(5)
124+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
125+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
126+
* .setRetryDelayMultiplier(1.3)
127+
* .setRpcTimeoutMultiplier(1.5)
128+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
120129
* .build());
121130
* FirestoreAdminSettings firestoreAdminSettings = firestoreAdminSettingsBuilder.build();
122131
* }</pre>
132+
*
133+
* Please refer to the [Client Side Retry
134+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
135+
* additional support in setting retries.
136+
*
137+
* <p>To configure the RetrySettings of a Long Running Operation method, create an
138+
* OperationTimedPollAlgorithm object and update the RPC's polling algorithm. For example, to
139+
* configure the RetrySettings for createIndex:
140+
*
141+
* <pre>{@code
142+
* // This snippet has been automatically generated and should be regarded as a code template only.
143+
* // It will require modifications to work:
144+
* // - It may require correct/in-range values for request initialization.
145+
* // - It may require specifying regional endpoints when creating the service client as shown in
146+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
147+
* FirestoreAdminSettings.Builder firestoreAdminSettingsBuilder =
148+
* FirestoreAdminSettings.newBuilder();
149+
* TimedRetryAlgorithm timedRetryAlgorithm =
150+
* OperationalTimedPollAlgorithm.create(
151+
* RetrySettings.newBuilder()
152+
* .setInitialRetryDelayDuration(Duration.ofMillis(500))
153+
* .setRetryDelayMultiplier(1.5)
154+
* .setMaxRetryDelay(Duration.ofMillis(5000))
155+
* .setTotalTimeoutDuration(Duration.ofHours(24))
156+
* .build());
157+
* firestoreAdminSettingsBuilder
158+
* .createClusterOperationSettings()
159+
* .setPollingAlgorithm(timedRetryAlgorithm)
160+
* .build();
161+
* }</pre>
123162
*/
124163
@Generated("by gapic-generator-java")
125164
public class FirestoreAdminSettings extends ClientSettings<FirestoreAdminSettings> {

‎java-firestore/google-cloud-firestore-admin/src/main/java/com/google/cloud/firestore/v1/stub/FirestoreAdminStubSettings.java‎

Lines changed: 43 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,9 @@
120120
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
121121
* build() is called, the tree of builders is called to create the complete settings object.
122122
*
123-
* <p>For example, to set the total timeout of getIndex to 30 seconds:
123+
* <p>For example, to set the
124+
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
125+
* of getIndex:
124126
*
125127
* <pre>{@code
126128
* // This snippet has been automatically generated and should be regarded as a code template only.
@@ -137,10 +139,47 @@
137139
* .getIndexSettings()
138140
* .getRetrySettings()
139141
* .toBuilder()
140-
* .setTotalTimeout(Duration.ofSeconds(30))
142+
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
143+
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
144+
* .setMaxAttempts(5)
145+
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
146+
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
147+
* .setRetryDelayMultiplier(1.3)
148+
* .setRpcTimeoutMultiplier(1.5)
149+
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
141150
* .build());
142151
* FirestoreAdminStubSettings firestoreAdminSettings = firestoreAdminSettingsBuilder.build();
143152
* }</pre>
153+
*
154+
* Please refer to the [Client Side Retry
155+
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
156+
* additional support in setting retries.
157+
*
158+
* <p>To configure the RetrySettings of a Long Running Operation method, create an
159+
* OperationTimedPollAlgorithm object and update the RPC's polling algorithm. For example, to
160+
* configure the RetrySettings for createIndex:
161+
*
162+
* <pre>{@code
163+
* // This snippet has been automatically generated and should be regarded as a code template only.
164+
* // It will require modifications to work:
165+
* // - It may require correct/in-range values for request initialization.
166+
* // - It may require specifying regional endpoints when creating the service client as shown in
167+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
168+
* FirestoreAdminStubSettings.Builder firestoreAdminSettingsBuilder =
169+
* FirestoreAdminStubSettings.newBuilder();
170+
* TimedRetryAlgorithm timedRetryAlgorithm =
171+
* OperationalTimedPollAlgorithm.create(
172+
* RetrySettings.newBuilder()
173+
* .setInitialRetryDelayDuration(Duration.ofMillis(500))
174+
* .setRetryDelayMultiplier(1.5)
175+
* .setMaxRetryDelay(Duration.ofMillis(5000))
176+
* .setTotalTimeoutDuration(Duration.ofHours(24))
177+
* .build());
178+
* firestoreAdminSettingsBuilder
179+
* .createClusterOperationSettings()
180+
* .setPollingAlgorithm(timedRetryAlgorithm)
181+
* .build();
182+
* }</pre>
144183
*/
145184
@Generated("by gapic-generator-java")
146185
public class FirestoreAdminStubSettings extends StubSettings<FirestoreAdminStubSettings> {
@@ -234,9 +273,7 @@ public String extractNextToken(ListIndexesResponse payload) {
234273

235274
@Override
236275
public Iterable<Index> extractResources(ListIndexesResponse payload) {
237-
return payload.getIndexesList() == null
238-
? ImmutableList.<Index>of()
239-
: payload.getIndexesList();
276+
return payload.getIndexesList();
240277
}
241278
};
242279

@@ -270,9 +307,7 @@ public String extractNextToken(ListFieldsResponse payload) {
270307

271308
@Override
272309
public Iterable<Field> extractResources(ListFieldsResponse payload) {
273-
return payload.getFieldsList() == null
274-
? ImmutableList.<Field>of()
275-
: payload.getFieldsList();
310+
return payload.getFieldsList();
276311
}
277312
};
278313

‎java-firestore/google-cloud-firestore-admin/src/main/resources/META-INF/native-image/com.google.cloud.firestore.v1/reflect-config.json‎

Lines changed: 144 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -305,6 +305,24 @@
305305
"allDeclaredClasses": true,
306306
"allPublicClasses": true
307307
},
308+
{
309+
"name": "com.google.api.PythonSettings$ExperimentalFeatures",
310+
"queryAllDeclaredConstructors": true,
311+
"queryAllPublicConstructors": true,
312+
"queryAllDeclaredMethods": true,
313+
"allPublicMethods": true,
314+
"allDeclaredClasses": true,
315+
"allPublicClasses": true
316+
},
317+
{
318+
"name": "com.google.api.PythonSettings$ExperimentalFeatures$Builder",
319+
"queryAllDeclaredConstructors": true,
320+
"queryAllPublicConstructors": true,
321+
"queryAllDeclaredMethods": true,
322+
"allPublicMethods": true,
323+
"allDeclaredClasses": true,
324+
"allPublicClasses": true
325+
},
308326
{
309327
"name": "com.google.api.ResourceDescriptor",
310328
"queryAllDeclaredConstructors": true,
@@ -683,6 +701,24 @@
683701
"allDeclaredClasses": true,
684702
"allPublicClasses": true
685703
},
704+
{
705+
"name": "com.google.firestore.admin.v1.Database$CmekConfig",
706+
"queryAllDeclaredConstructors": true,
707+
"queryAllPublicConstructors": true,
708+
"queryAllDeclaredMethods": true,
709+
"allPublicMethods": true,
710+
"allDeclaredClasses": true,
711+
"allPublicClasses": true
712+
},
713+
{
714+
"name": "com.google.firestore.admin.v1.Database$CmekConfig$Builder",
715+
"queryAllDeclaredConstructors": true,
716+
"queryAllPublicConstructors": true,
717+
"queryAllDeclaredMethods": true,
718+
"allPublicMethods": true,
719+
"allDeclaredClasses": true,
720+
"allPublicClasses": true
721+
},
686722
{
687723
"name": "com.google.firestore.admin.v1.Database$ConcurrencyMode",
688724
"queryAllDeclaredConstructors": true,
@@ -710,6 +746,78 @@
710746
"allDeclaredClasses": true,
711747
"allPublicClasses": true
712748
},
749+
{
750+
"name": "com.google.firestore.admin.v1.Database$EncryptionConfig",
751+
"queryAllDeclaredConstructors": true,
752+
"queryAllPublicConstructors": true,
753+
"queryAllDeclaredMethods": true,
754+
"allPublicMethods": true,
755+
"allDeclaredClasses": true,
756+
"allPublicClasses": true
757+
},
758+
{
759+
"name": "com.google.firestore.admin.v1.Database$EncryptionConfig$Builder",
760+
"queryAllDeclaredConstructors": true,
761+
"queryAllPublicConstructors": true,
762+
"queryAllDeclaredMethods": true,
763+
"allPublicMethods": true,
764+
"allDeclaredClasses": true,
765+
"allPublicClasses": true
766+
},
767+
{
768+
"name": "com.google.firestore.admin.v1.Database$EncryptionConfig$CustomerManagedEncryptionOptions",
769+
"queryAllDeclaredConstructors": true,
770+
"queryAllPublicConstructors": true,
771+
"queryAllDeclaredMethods": true,
772+
"allPublicMethods": true,
773+
"allDeclaredClasses": true,
774+
"allPublicClasses": true
775+
},
776+
{
777+
"name": "com.google.firestore.admin.v1.Database$EncryptionConfig$CustomerManagedEncryptionOptions$Builder",
778+
"queryAllDeclaredConstructors": true,
779+
"queryAllPublicConstructors": true,
780+
"queryAllDeclaredMethods": true,
781+
"allPublicMethods": true,
782+
"allDeclaredClasses": true,
783+
"allPublicClasses": true
784+
},
785+
{
786+
"name": "com.google.firestore.admin.v1.Database$EncryptionConfig$GoogleDefaultEncryptionOptions",
787+
"queryAllDeclaredConstructors": true,
788+
"queryAllPublicConstructors": true,
789+
"queryAllDeclaredMethods": true,
790+
"allPublicMethods": true,
791+
"allDeclaredClasses": true,
792+
"allPublicClasses": true
793+
},
794+
{
795+
"name": "com.google.firestore.admin.v1.Database$EncryptionConfig$GoogleDefaultEncryptionOptions$Builder",
796+
"queryAllDeclaredConstructors": true,
797+
"queryAllPublicConstructors": true,
798+
"queryAllDeclaredMethods": true,
799+
"allPublicMethods": true,
800+
"allDeclaredClasses": true,
801+
"allPublicClasses": true
802+
},
803+
{
804+
"name": "com.google.firestore.admin.v1.Database$EncryptionConfig$SourceEncryptionOptions",
805+
"queryAllDeclaredConstructors": true,
806+
"queryAllPublicConstructors": true,
807+
"queryAllDeclaredMethods": true,
808+
"allPublicMethods": true,
809+
"allDeclaredClasses": true,
810+
"allPublicClasses": true
811+
},
812+
{
813+
"name": "com.google.firestore.admin.v1.Database$EncryptionConfig$SourceEncryptionOptions$Builder",
814+
"queryAllDeclaredConstructors": true,
815+
"queryAllPublicConstructors": true,
816+
"queryAllDeclaredMethods": true,
817+
"allPublicMethods": true,
818+
"allDeclaredClasses": true,
819+
"allPublicClasses": true
820+
},
713821
{
714822
"name": "com.google.firestore.admin.v1.Database$PointInTimeRecoveryEnablement",
715823
"queryAllDeclaredConstructors": true,
@@ -719,6 +827,42 @@
719827
"allDeclaredClasses": true,
720828
"allPublicClasses": true
721829
},
830+
{
831+
"name": "com.google.firestore.admin.v1.Database$SourceInfo",
832+
"queryAllDeclaredConstructors": true,
833+
"queryAllPublicConstructors": true,
834+
"queryAllDeclaredMethods": true,
835+
"allPublicMethods": true,
836+
"allDeclaredClasses": true,
837+
"allPublicClasses": true
838+
},
839+
{
840+
"name": "com.google.firestore.admin.v1.Database$SourceInfo$BackupSource",
841+
"queryAllDeclaredConstructors": true,
842+
"queryAllPublicConstructors": true,
843+
"queryAllDeclaredMethods": true,
844+
"allPublicMethods": true,
845+
"allDeclaredClasses": true,
846+
"allPublicClasses": true
847+
},
848+
{
849+
"name": "com.google.firestore.admin.v1.Database$SourceInfo$BackupSource$Builder",
850+
"queryAllDeclaredConstructors": true,
851+
"queryAllPublicConstructors": true,
852+
"queryAllDeclaredMethods": true,
853+
"allPublicMethods": true,
854+
"allDeclaredClasses": true,
855+
"allPublicClasses": true
856+
},
857+
{
858+
"name": "com.google.firestore.admin.v1.Database$SourceInfo$Builder",
859+
"queryAllDeclaredConstructors": true,
860+
"queryAllPublicConstructors": true,
861+
"queryAllDeclaredMethods": true,
862+
"allPublicMethods": true,
863+
"allDeclaredClasses": true,
864+
"allPublicClasses": true
865+
},
722866
{
723867
"name": "com.google.firestore.admin.v1.DeleteBackupRequest",
724868
"queryAllDeclaredConstructors": true,

0 commit comments

Comments
 (0)