chore(bazel): Update WORKSPACE files for rules_gapic, gax_java, gener…

…ator_java versions (#719) - [ ] Regenerate this pull request now. PiperOrigin-RevId: 472750037 Source-Link: googleapis/googleapis@88f2ea3 Source-Link: https://github.com/googleapis/googleapis-gen/commit/230a5588306aae18fe8f2a57f14d4039ad72c901 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjMwYTU1ODgzMDZhYWUxOGZlOGYyYTU3ZjE0ZDQwMzlhZDcyYzkwMSJ9
googleapis · Sep 9, 2022 · ebe19b3 · ebe19b3
1 parent d594cb2
commit ebe19b3
Show file tree

Hide file tree

Showing 5 changed files with 119 additions and 50 deletions.
diff --git a/...amcredentials/src/main/java/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java b/...amcredentials/src/main/java/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java
@@ -42,8 +42,11 @@
  * calls that map to API methods. Sample code to get started:
  *
  * <pre>{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // 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
  * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
  *   ServiceAccountName name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]");
  *   List<String> delegates = new ArrayList<>();
@@ -83,8 +86,11 @@
  * <p>To customize credentials:
  *
  * <pre>{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // 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
  * IamCredentialsSettings iamCredentialsSettings =
  *     IamCredentialsSettings.newBuilder()
  *         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -95,8 +101,11 @@
  * <p>To customize the endpoint:
  *
  * <pre>{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // 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
  * IamCredentialsSettings iamCredentialsSettings =
  *     IamCredentialsSettings.newBuilder().setEndpoint(myEndpoint).build();
  * IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create(iamCredentialsSettings);
@@ -106,8 +115,11 @@
  * the wire:
  *
  * <pre>{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // 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
  * IamCredentialsSettings iamCredentialsSettings =
  *     IamCredentialsSettings.newBuilder()
  *         .setTransportChannelProvider(
@@ -175,8 +187,11 @@ public IamCredentialsStub getStub() {
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   ServiceAccountName name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]");
    *   List<String> delegates = new ArrayList<>();
@@ -226,8 +241,11 @@ public final GenerateAccessTokenResponse generateAccessToken(
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   String name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]").toString();
    *   List<String> delegates = new ArrayList<>();
@@ -277,8 +295,11 @@ public final GenerateAccessTokenResponse generateAccessToken(
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   GenerateAccessTokenRequest request =
    *       GenerateAccessTokenRequest.newBuilder()
@@ -305,8 +326,11 @@ public final GenerateAccessTokenResponse generateAccessToken(GenerateAccessToken
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   GenerateAccessTokenRequest request =
    *       GenerateAccessTokenRequest.newBuilder()
@@ -334,8 +358,11 @@ public final GenerateAccessTokenResponse generateAccessToken(GenerateAccessToken
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   ServiceAccountName name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]");
    *   List<String> delegates = new ArrayList<>();
@@ -383,8 +410,11 @@ public final GenerateIdTokenResponse generateIdToken(
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   String name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]").toString();
    *   List<String> delegates = new ArrayList<>();
@@ -432,8 +462,11 @@ public final GenerateIdTokenResponse generateIdToken(
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   GenerateIdTokenRequest request =
    *       GenerateIdTokenRequest.newBuilder()
@@ -460,8 +493,11 @@ public final GenerateIdTokenResponse generateIdToken(GenerateIdTokenRequest requ
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   GenerateIdTokenRequest request =
    *       GenerateIdTokenRequest.newBuilder()
@@ -489,8 +525,11 @@ public final GenerateIdTokenResponse generateIdToken(GenerateIdTokenRequest requ
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   ServiceAccountName name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]");
    *   List<String> delegates = new ArrayList<>();
@@ -532,8 +571,11 @@ public final SignBlobResponse signBlob(
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   String name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]").toString();
    *   List<String> delegates = new ArrayList<>();
@@ -574,8 +616,11 @@ public final SignBlobResponse signBlob(String name, List<String> delegates, Byte
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   SignBlobRequest request =
    *       SignBlobRequest.newBuilder()
@@ -601,8 +646,11 @@ public final SignBlobResponse signBlob(SignBlobRequest request) {
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   SignBlobRequest request =
    *       SignBlobRequest.newBuilder()
@@ -628,8 +676,11 @@ public final UnaryCallable<SignBlobRequest, SignBlobResponse> signBlobCallable()
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   ServiceAccountName name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]");
    *   List<String> delegates = new ArrayList<>();
@@ -671,8 +722,11 @@ public final SignJwtResponse signJwt(
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   String name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]").toString();
    *   List<String> delegates = new ArrayList<>();
@@ -713,8 +767,11 @@ public final SignJwtResponse signJwt(String name, List<String> delegates, String
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   SignJwtRequest request =
    *       SignJwtRequest.newBuilder()
@@ -740,8 +797,11 @@ public final SignJwtResponse signJwt(SignJwtRequest request) {
    * <p>Sample code:
    *
    * <pre>{@code
-   * // This snippet has been automatically generated for illustrative purposes only.
-   * // It may require modifications to work in your environment.
+   * // 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
    * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
    *   SignJwtRequest request =
    *       SignJwtRequest.newBuilder()

diff --git a/...credentials/src/main/java/com/google/cloud/iam/credentials/v1/IamCredentialsSettings.java b/...credentials/src/main/java/com/google/cloud/iam/credentials/v1/IamCredentialsSettings.java
@@ -51,8 +51,11 @@
  * <p>For example, to set the total timeout of generateAccessToken to 30 seconds:
  *
  * <pre>{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // 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
  * IamCredentialsSettings.Builder iamCredentialsSettingsBuilder =
  *     IamCredentialsSettings.newBuilder();
  * iamCredentialsSettingsBuilder

diff --git a/...-cloud-iamcredentials/src/main/java/com/google/cloud/iam/credentials/v1/package-info.java b/...-cloud-iamcredentials/src/main/java/com/google/cloud/iam/credentials/v1/package-info.java
@@ -31,8 +31,11 @@
  * <p>Sample for IamCredentialsClient:
  *
  * <pre>{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // 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
  * try (IamCredentialsClient iamCredentialsClient = IamCredentialsClient.create()) {
  *   ServiceAccountName name = ServiceAccountName.of("[PROJECT]", "[SERVICE_ACCOUNT]");
  *   List<String> delegates = new ArrayList<>();