fix: [vertexai] deprecate varargs scopes in VertexAI (#10328)

PiperOrigin-RevId: 604674686

Co-authored-by: Jaycee Li <jayceeli@google.com>

Author: copybara-service[bot]

java-vertexai/README.md

@@ -505,4 +505,4 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
 [oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
 [g-c-j]: http://github.com/googleapis/google-cloud-java
-[generative-ai-studio]: https://cloud.google.com/generative-ai-studio?hl=en
+[generative-ai-studio]: https://cloud.google.com/generative-ai-studio?hl=en

java-vertexai/google-cloud-vertexai/src/main/java/com/google/cloud/vertexai/VertexAI.java

@@ -29,6 +29,7 @@
 import com.google.cloud.vertexai.api.PredictionServiceSettings;
 import java.io.IOException;
 import java.util.Arrays;
+import java.util.List;
 import java.util.logging.Level;
 import java.util.logging.Logger;
 
@@ -60,16 +61,38 @@ public class VertexAI implements AutoCloseable {
   private LlmUtilityServiceClient llmUtilityRestClient = null;
 
   /**
-   * Construct a VertexAI instance with custom credentials.
+   * Construct a VertexAI instance.
    *
    * @param projectId the default project to use when making API calls
    * @param location the default location to use when making API calls
-   * @param credentials the custom credentials to use when making API calls
    */
-  public VertexAI(String projectId, String location, Credentials credentials) {
+  public VertexAI(String projectId, String location) {
     this.projectId = projectId;
     this.location = location;
     this.apiEndpoint = String.format("%s-aiplatform.googleapis.com", this.location);
+  }
+
+  /**
+   * Construct a VertexAI instance with default transport layer.
+   *
+   * @param projectId the default project to use when making API calls
+   * @param location the default location to use when making API calls
+   * @param transport the default {@link Transport} layer to use to send API requests
+   */
+  public VertexAI(String projectId, String location, Transport transport) {
+    this(projectId, location);
+    this.transport = transport;
+  }
+
+  /**
+   * Construct a VertexAI instance with custom credentials.
+   *
+   * @param projectId the default project to use when making API calls
+   * @param location the default location to use when making API calls
+   * @param credentials the custom credentials to use when making API calls
+   */
+  public VertexAI(String projectId, String location, Credentials credentials) {
+    this(projectId, location);
     this.credentialsProvider = FixedCredentialsProvider.create(credentials);
   }
 
@@ -91,9 +114,47 @@ public VertexAI(String projectId, String location, Transport transport, Credenti
    *
    * @param projectId the default project to use when making API calls
    * @param location the default location to use when making API calls
+   * @param scopes List of scopes in the default credentials. Make sure you have specified
+   *     "https://www.googleapis.com/auth/cloud-platform" scope to access resources on Vertex AI.
+   */
+  public VertexAI(String projectId, String location, List<String> scopes) throws IOException {
+    this(projectId, location);
+
+    CredentialsProvider credentialsProvider =
+        scopes.size() == 0
+            ? null
+            : GoogleCredentialsProvider.newBuilder()
+                .setScopesToApply(scopes)
+                .setUseJwtAccessWithScope(true)
+                .build();
+    this.credentialsProvider = credentialsProvider;
+  }
+
+  /**
+   * Construct a VertexAI instance with default transport layer and application default credentials.
+   *
+   * @param projectId the default project to use when making API calls
+   * @param location the default location to use when making API calls
+   * @param transport the default {@link Transport} layer to use to send API requests
+   * @param scopes List of scopes in the default credentials. Make sure you have specified
+   *     "https://www.googleapis.com/auth/cloud-platform" scope to access resources on Vertex AI.
+   */
+  public VertexAI(String projectId, String location, Transport transport, List<String> scopes)
+      throws IOException {
+    this(projectId, location, scopes);
+    this.transport = transport;
+  }
+
+  /**
+   * Construct a VertexAI instance with application default credentials.
+   *
+   * @deprecated Use {@link #VertexAI(String, String, List<String>)} instead.
+   * @param projectId the default project to use when making API calls
+   * @param location the default location to use when making API calls
    * @param scopes collection of scopes in the default credentials. Make sure you have specified
    *     "https://www.googleapis.com/auth/cloud-platform" scope to access resources on Vertex AI.
    */
+  @Deprecated
   public VertexAI(String projectId, String location, String... scopes) throws IOException {
     CredentialsProvider credentialsProvider =
         scopes.length == 0
@@ -112,11 +173,13 @@ public VertexAI(String projectId, String location, String... scopes) throws IOEx
   /**
    * Construct a VertexAI instance with default transport layer and application default credentials.
    *
+   * @deprecated Use {@link #VertexAI(String, String, Transport, List<String>)} instead.
    * @param projectId the default project to use when making API calls
    * @param location the default location to use when making API calls
    * @param transport the default {@link Transport} layer to use to send API requests
    * @param scopes collection of scopes in the default credentials
    */
+  @Deprecated
   public VertexAI(String projectId, String location, Transport transport, String... scopes)
       throws IOException {
     this(projectId, location, scopes);