Merge branch 'main' into PR #3942 to update

Author: lqiu96

benchmark/pom.xml

@@ -6,7 +6,7 @@
   <parent>
     <artifactId>google-cloud-bigquery-parent</artifactId>
     <groupId>com.google.cloud</groupId>
-    <version>2.57.1</version><!-- {x-version-update:google-cloud-bigquery:current} -->
+    <version>2.57.2-SNAPSHOT</version><!-- {x-version-update:google-cloud-bigquery:current} -->
   </parent>
 
   <properties>

google-cloud-bigquery-bom/pom.xml

@@ -3,7 +3,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.google.cloud</groupId>
     <artifactId>google-cloud-bigquery-bom</artifactId>
-    <version>2.57.1</version><!-- {x-version-update:google-cloud-bigquery:current} -->
+    <version>2.57.2-SNAPSHOT</version><!-- {x-version-update:google-cloud-bigquery:current} -->
     <packaging>pom</packaging>
     <parent>
         <groupId>com.google.cloud</groupId>
@@ -54,7 +54,7 @@
         <dependency>
           <groupId>com.google.cloud</groupId>
           <artifactId>google-cloud-bigquery</artifactId>
-          <version>2.57.1</version><!-- {x-version-update:google-cloud-bigquery:current} -->
+          <version>2.57.2-SNAPSHOT</version><!-- {x-version-update:google-cloud-bigquery:current} -->
         </dependency>
       </dependencies>
     </dependencyManagement>

google-cloud-bigquery/pom.xml

@@ -3,15 +3,15 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.google.cloud</groupId>
   <artifactId>google-cloud-bigquery</artifactId>
-  <version>2.57.1</version><!-- {x-version-update:google-cloud-bigquery:current} -->
+  <version>2.57.2-SNAPSHOT</version><!-- {x-version-update:google-cloud-bigquery:current} -->
   <packaging>jar</packaging>
   <name>BigQuery</name>
   <url>https://github.com/googleapis/java-bigquery</url>
   <description>BigQuery</description>
   <parent>
     <groupId>com.google.cloud</groupId>
     <artifactId>google-cloud-bigquery-parent</artifactId>
-    <version>2.57.1</version><!-- {x-version-update:google-cloud-bigquery:current} -->
+    <version>2.57.2-SNAPSHOT</version><!-- {x-version-update:google-cloud-bigquery:current} -->
   </parent>
   <properties>
     <site.installationModule>google-cloud-bigquery</site.installationModule>

google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryParameterValue.java

@@ -328,9 +328,9 @@ public static QueryParameterValue timestamp(Long value) {
    * <p>This method supports up to picosecond precision (12 digits) for timestamp. Input should
    * conform to ISO8601 format.
    *
-   * <p>Must be in the format "yyyy-MM-dd HH:mm:ss.SSSSSS{SSSSSSS}ZZ", e.g. "2014-08-19
-   * 12:41:35.123456+00:00" for microsecond precision and "2014-08-19 12:41:35.123456789123+00:00"
-   * for picosecond precision
+   * <p>Should be in the format "yyyy-MM-dd HH:mm:ss.SSSSSS{SSSSSSS}Z", e.g. "2014-08-19
+   * 12:41:35.123456Z" for microsecond precision and "2014-08-19 12:41:35.123456789123Z" for
+   * picosecond precision
    */
   public static QueryParameterValue timestamp(String value) {
     return of(value, StandardSQLTypeName.TIMESTAMP);

google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/testing/RemoteBigQueryHelper.java

@@ -120,18 +120,27 @@ public static RemoteBigQueryHelper create(String projectId, InputStream keyStrea
    * credentials.
    */
   public static RemoteBigQueryHelper create() {
+    return create(BigQueryOptions.newBuilder());
+  }
+
+  /**
+   * Creates a {@code RemoteBigQueryHelper} object using default project id and authentication
+   * credentials.
+   *
+   * @param bigqueryOptionsBuilder Custom BigqueryOptions.Builder with some pre-defined settings
+   */
+  public static RemoteBigQueryHelper create(BigQueryOptions.Builder bigqueryOptionsBuilder) {
     HttpTransportOptions transportOptions = BigQueryOptions.getDefaultHttpTransportOptions();
     transportOptions =
         transportOptions.toBuilder()
             .setConnectTimeout(connectTimeout)
             .setReadTimeout(connectTimeout)
             .build();
-    BigQueryOptions bigqueryOptions =
-        BigQueryOptions.newBuilder()
+    BigQueryOptions.Builder builder =
+        bigqueryOptionsBuilder
             .setRetrySettings(retrySettings())
-            .setTransportOptions(transportOptions)
-            .build();
-    return new RemoteBigQueryHelper(bigqueryOptions);
+            .setTransportOptions(transportOptions);
+    return new RemoteBigQueryHelper(builder.build());
   }
 
   private static RetrySettings retrySettings() {