docs: Update docs for GoogleCredentialsProvider#setScopesToApply (#4057)

blakeli0 · web-flow · commit 0a9962f9945b · 2026-01-13T21:15:20.000Z
[GoogleCredentialsProvider#setScopesToApply](https://github.com/googleapis/sdk-platform-java/blob/b9a8c8924e7b03bca8a97e476abfd012b86f6d45/gax-java/gax/src/main/java/com/google/api/gax/core/GoogleCredentialsProvider.java#L123) would only work if the underlying credentials require the scopes to be set. Update the docs to reflect the intended behavior. Fixes googleapis/sdk-platform-java#3738
diff --git a/gax-java/gax/src/main/java/com/google/api/gax/core/GoogleCredentialsProvider.java b/gax-java/gax/src/main/java/com/google/api/gax/core/GoogleCredentialsProvider.java
@@ -118,7 +118,9 @@ public abstract static class Builder {
 
     /**
      * Sets the scopes to apply to the credentials that are acquired from Application Default
-     * Credentials, before the credentials are sent to the service.
+     * Credentials, before the credentials are sent to the service. These scopes only take effect if
+     * the underlying credentials require them. See {@link GoogleCredentials#createScopedRequired()}
+     * for more details on when scopes are necessary.
      */
     public abstract Builder setScopesToApply(List<String> val);
 
