chore: Update generation configuration at Thu Sep 19 02:22:35 UTC 2024

generation_config.yaml

@@ -1,6 +1,6 @@
-gapic_generator_version: 2.44.0
-googleapis_commitish: a8f277295c12490d49c196b791e2101500864c30
-libraries_bom_version: 26.44.0
+gapic_generator_version: 2.45.0
+googleapis_commitish: 607c2ae82620153880a66898bcbf0a46d38d7d10
+libraries_bom_version: 26.46.0
 
 # the libraries are ordered with respect to library name, which is
 # java-{library.library_name} or java-{library.api-shortname} when

java-accessapproval/README.md

@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.44.0</version>
+ <version>26.46.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>
@@ -32,6 +32,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-accessapproval</artifactId>
  </dependency>
+</dependencies>
 ```
 
 If you are using Maven without the BOM, add this to your dependencies:
@@ -195,7 +196,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-accessapproval.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-accessapproval/2.48.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-accessapproval/2.50.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-accessapproval/google-cloud-accessapproval/src/main/java/com/google/cloud/accessapproval/v1/AccessApprovalAdminSettings.java

@@ -52,7 +52,9 @@
  * <p>The builder of this class is recursive, so contained classes are themselves builders. When
  * build() is called, the tree of builders is called to create the complete settings object.
  *
- * <p>For example, to set the total timeout of getApprovalRequest to 30 seconds:
+ * <p>For example, to set the
+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
+ * of getApprovalRequest:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -69,11 +71,22 @@
  * .getApprovalRequestSettings()
  * .getRetrySettings()
  * .toBuilder()
- * .setTotalTimeout(Duration.ofSeconds(30))
+ * .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ * .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ * .setMaxAttempts(5)
+ * .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ * .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ * .setRetryDelayMultiplier(1.3)
+ * .setRpcTimeoutMultiplier(1.5)
+ * .setTotalTimeoutDuration(Duration.ofSeconds(300))
  * .build());
  * AccessApprovalAdminSettings accessApprovalAdminSettings =
  * accessApprovalAdminSettingsBuilder.build();
  * }</pre>
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
+ * additional support in setting retries.
  */
 @Generated("by gapic-generator-java")
 public class AccessApprovalAdminSettings extends ClientSettings<AccessApprovalAdminSettings> {

java-accessapproval/google-cloud-accessapproval/src/main/java/com/google/cloud/accessapproval/v1/stub/AccessApprovalStubSettings.java

@@ -83,7 +83,9 @@
  * <p>The builder of this class is recursive, so contained classes are themselves builders. When
  * build() is called, the tree of builders is called to create the complete settings object.
  *
- * <p>For example, to set the total timeout of getApprovalRequest to 30 seconds:
+ * <p>For example, to set the
+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
+ * of getApprovalRequest:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -100,11 +102,22 @@
  * .getApprovalRequestSettings()
  * .getRetrySettings()
  * .toBuilder()
- * .setTotalTimeout(Duration.ofSeconds(30))
+ * .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ * .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ * .setMaxAttempts(5)
+ * .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ * .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ * .setRetryDelayMultiplier(1.3)
+ * .setRpcTimeoutMultiplier(1.5)
+ * .setTotalTimeoutDuration(Duration.ofSeconds(300))
  * .build());
  * AccessApprovalStubSettings accessApprovalAdminSettings =
  * accessApprovalAdminSettingsBuilder.build();
  * }</pre>
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
+ * additional support in setting retries.
  */
 @Generated("by gapic-generator-java")
 public class AccessApprovalStubSettings extends StubSettings<AccessApprovalStubSettings> {
@@ -170,9 +183,7 @@ public String extractNextToken(ListApprovalRequestsResponse payload) {
  @Override
  public Iterable<ApprovalRequest> extractResources(
  ListApprovalRequestsResponse payload) {
- return payload.getApprovalRequestsList() == null
- ? ImmutableList.<ApprovalRequest>of()
- : payload.getApprovalRequestsList();
+ return payload.getApprovalRequestsList();
  }
  };
 

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

@@ -305,6 +305,24 @@
  "allDeclaredClasses": true,
  "allPublicClasses": true
  },
+ {
+ "name": "com.google.api.PythonSettings$ExperimentalFeatures",
+ "queryAllDeclaredConstructors": true,
+ "queryAllPublicConstructors": true,
+ "queryAllDeclaredMethods": true,
+ "allPublicMethods": true,
+ "allDeclaredClasses": true,
+ "allPublicClasses": true
+ },
+ {
+ "name": "com.google.api.PythonSettings$ExperimentalFeatures$Builder",
+ "queryAllDeclaredConstructors": true,
+ "queryAllPublicConstructors": true,
+ "queryAllDeclaredMethods": true,
+ "allPublicMethods": true,
+ "allDeclaredClasses": true,
+ "allPublicClasses": true
+ },
  {
  "name": "com.google.api.ResourceDescriptor",
  "queryAllDeclaredConstructors": true,

java-accessapproval/samples/snippets/generated/com/google/cloud/accessapproval/v1/accessapprovaladminsettings/getapprovalrequest/SyncGetApprovalRequest.java

@@ -41,7 +41,14 @@ public static void syncGetApprovalRequest() throws Exception {
  .getApprovalRequestSettings()
  .getRetrySettings()
  .toBuilder()
- .setTotalTimeout(Duration.ofSeconds(30))
+ .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ .setMaxAttempts(5)
+ .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ .setRetryDelayMultiplier(1.3)
+ .setRpcTimeoutMultiplier(1.5)
+ .setTotalTimeoutDuration(Duration.ofSeconds(300))
  .build());
  AccessApprovalAdminSettings accessApprovalAdminSettings =
  accessApprovalAdminSettingsBuilder.build();

java-accessapproval/samples/snippets/generated/com/google/cloud/accessapproval/v1/stub/accessapprovalstubsettings/getapprovalrequest/SyncGetApprovalRequest.java

@@ -41,7 +41,14 @@ public static void syncGetApprovalRequest() throws Exception {
  .getApprovalRequestSettings()
  .getRetrySettings()
  .toBuilder()
- .setTotalTimeout(Duration.ofSeconds(30))
+ .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ .setMaxAttempts(5)
+ .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ .setRetryDelayMultiplier(1.3)
+ .setRpcTimeoutMultiplier(1.5)
+ .setTotalTimeoutDuration(Duration.ofSeconds(300))
  .build());
  AccessApprovalStubSettings accessApprovalAdminSettings =
  accessApprovalAdminSettingsBuilder.build();

java-accesscontextmanager/README.md

@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.44.0</version>
+ <version>26.46.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>
@@ -32,6 +32,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
  <groupId>com.google.cloud</groupId>
  <artifactId>google-identity-accesscontextmanager</artifactId>
  </dependency>
+</dependencies>
 ```
 
 If you are using Maven without the BOM, add this to your dependencies:
@@ -195,7 +196,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-identity-accesscontextmanager.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-identity-accesscontextmanager/1.48.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-identity-accesscontextmanager/1.50.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-accesscontextmanager/google-identity-accesscontextmanager/src/main/java/com/google/identity/accesscontextmanager/v1/AccessContextManagerSettings.java

@@ -62,7 +62,9 @@
  * <p>The builder of this class is recursive, so contained classes are themselves builders. When
  * build() is called, the tree of builders is called to create the complete settings object.
  *
- * <p>For example, to set the total timeout of getAccessPolicy to 30 seconds:
+ * <p>For example, to set the
+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
+ * of getAccessPolicy:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -79,11 +81,48 @@
  * .getAccessPolicySettings()
  * .getRetrySettings()
  * .toBuilder()
- * .setTotalTimeout(Duration.ofSeconds(30))
+ * .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ * .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ * .setMaxAttempts(5)
+ * .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ * .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ * .setRetryDelayMultiplier(1.3)
+ * .setRpcTimeoutMultiplier(1.5)
+ * .setTotalTimeoutDuration(Duration.ofSeconds(300))
  * .build());
  * AccessContextManagerSettings accessContextManagerSettings =
  * accessContextManagerSettingsBuilder.build();
  * }</pre>
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
+ * additional support in setting retries.
+ *
+ * <p>To configure the RetrySettings of a Long Running Operation method, create an
+ * OperationTimedPollAlgorithm object and update the RPC's polling algorithm. For example, to
+ * configure the RetrySettings for createAccessPolicy:
+ *
+ * <pre>{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * AccessContextManagerSettings.Builder accessContextManagerSettingsBuilder =
+ * AccessContextManagerSettings.newBuilder();
+ * TimedRetryAlgorithm timedRetryAlgorithm =
+ * OperationalTimedPollAlgorithm.create(
+ * RetrySettings.newBuilder()
+ * .setInitialRetryDelayDuration(Duration.ofMillis(500))
+ * .setRetryDelayMultiplier(1.5)
+ * .setMaxRetryDelay(Duration.ofMillis(5000))
+ * .setTotalTimeoutDuration(Duration.ofHours(24))
+ * .build());
+ * accessContextManagerSettingsBuilder
+ * .createClusterOperationSettings()
+ * .setPollingAlgorithm(timedRetryAlgorithm)
+ * .build();
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 public class AccessContextManagerSettings extends ClientSettings<AccessContextManagerSettings> {

java-accesscontextmanager/google-identity-accesscontextmanager/src/main/java/com/google/identity/accesscontextmanager/v1/stub/AccessContextManagerStubSettings.java

@@ -118,7 +118,9 @@
  * <p>The builder of this class is recursive, so contained classes are themselves builders. When
  * build() is called, the tree of builders is called to create the complete settings object.
  *
- * <p>For example, to set the total timeout of getAccessPolicy to 30 seconds:
+ * <p>For example, to set the
+ * [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
+ * of getAccessPolicy:
  *
  * <pre>{@code
  * // This snippet has been automatically generated and should be regarded as a code template only.
@@ -135,11 +137,48 @@
  * .getAccessPolicySettings()
  * .getRetrySettings()
  * .toBuilder()
- * .setTotalTimeout(Duration.ofSeconds(30))
+ * .setInitialRetryDelayDuration(Duration.ofSeconds(1))
+ * .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
+ * .setMaxAttempts(5)
+ * .setMaxRetryDelayDuration(Duration.ofSeconds(30))
+ * .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
+ * .setRetryDelayMultiplier(1.3)
+ * .setRpcTimeoutMultiplier(1.5)
+ * .setTotalTimeoutDuration(Duration.ofSeconds(300))
  * .build());
  * AccessContextManagerStubSettings accessContextManagerSettings =
  * accessContextManagerSettingsBuilder.build();
  * }</pre>
+ *
+ * Please refer to the [Client Side Retry
+ * Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
+ * additional support in setting retries.
+ *
+ * <p>To configure the RetrySettings of a Long Running Operation method, create an
+ * OperationTimedPollAlgorithm object and update the RPC's polling algorithm. For example, to
+ * configure the RetrySettings for createAccessPolicy:
+ *
+ * <pre>{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * AccessContextManagerStubSettings.Builder accessContextManagerSettingsBuilder =
+ * AccessContextManagerStubSettings.newBuilder();
+ * TimedRetryAlgorithm timedRetryAlgorithm =
+ * OperationalTimedPollAlgorithm.create(
+ * RetrySettings.newBuilder()
+ * .setInitialRetryDelayDuration(Duration.ofMillis(500))
+ * .setRetryDelayMultiplier(1.5)
+ * .setMaxRetryDelay(Duration.ofMillis(5000))
+ * .setTotalTimeoutDuration(Duration.ofHours(24))
+ * .build());
+ * accessContextManagerSettingsBuilder
+ * .createClusterOperationSettings()
+ * .setPollingAlgorithm(timedRetryAlgorithm)
+ * .build();
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 public class AccessContextManagerStubSettings
@@ -288,9 +327,7 @@ public String extractNextToken(ListAccessPoliciesResponse payload) {
 
  @Override
  public Iterable<AccessPolicy> extractResources(ListAccessPoliciesResponse payload) {
- return payload.getAccessPoliciesList() == null
- ? ImmutableList.<AccessPolicy>of()
- : payload.getAccessPoliciesList();
+ return payload.getAccessPoliciesList();
  }
  };
 
@@ -328,9 +365,7 @@ public String extractNextToken(ListAccessLevelsResponse payload) {
 
  @Override
  public Iterable<AccessLevel> extractResources(ListAccessLevelsResponse payload) {
- return payload.getAccessLevelsList() == null
- ? ImmutableList.<AccessLevel>of()
- : payload.getAccessLevelsList();
+ return payload.getAccessLevelsList();
  }
  };
 
@@ -369,9 +404,7 @@ public String extractNextToken(ListServicePerimetersResponse payload) {
  @Override
  public Iterable<ServicePerimeter> extractResources(
  ListServicePerimetersResponse payload) {
- return payload.getServicePerimetersList() == null
- ? ImmutableList.<ServicePerimeter>of()
- : payload.getServicePerimetersList();
+ return payload.getServicePerimetersList();
  }
  };
 
@@ -416,9 +449,7 @@ public String extractNextToken(ListGcpUserAccessBindingsResponse payload) {
  @Override
  public Iterable<GcpUserAccessBinding> extractResources(
  ListGcpUserAccessBindingsResponse payload) {
- return payload.getGcpUserAccessBindingsList() == null
- ? ImmutableList.<GcpUserAccessBinding>of()
- : payload.getGcpUserAccessBindingsList();
+ return payload.getGcpUserAccessBindingsList();
  }
  };
 

java-accesscontextmanager/google-identity-accesscontextmanager/src/main/resources/META-INF/native-image/com.google.identity.accesscontextmanager.v1/reflect-config.json

@@ -305,6 +305,24 @@
  "allDeclaredClasses": true,
  "allPublicClasses": true
  },
+ {
+ "name": "com.google.api.PythonSettings$ExperimentalFeatures",
+ "queryAllDeclaredConstructors": true,
+ "queryAllPublicConstructors": true,
+ "queryAllDeclaredMethods": true,
+ "allPublicMethods": true,
+ "allDeclaredClasses": true,
+ "allPublicClasses": true
+ },
+ {
+ "name": "com.google.api.PythonSettings$ExperimentalFeatures$Builder",
+ "queryAllDeclaredConstructors": true,
+ "queryAllPublicConstructors": true,
+ "queryAllDeclaredMethods": true,
+ "allPublicMethods": true,
+ "allDeclaredClasses": true,
+ "allPublicClasses": true
+ },
  {
  "name": "com.google.api.ResourceDescriptor",
  "queryAllDeclaredConstructors": true,