docs(bigquery): add @BetaApi annotations and [Beta] Javadoc callouts

Author: jinseopkim0

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

@@ -21,7 +21,7 @@
 import java.io.Serializable;
 import java.util.Objects;
 
-/** Options specific to the Apache Arrow output format. */
+/** <b>[Beta]</b> Options specific to the Apache Arrow output format. */
 @BetaApi
 public final class ArrowSerializationOptions implements Serializable {
 
@@ -35,14 +35,22 @@ private ArrowSerializationOptions(Builder builder) {
     this.picosTimestampPrecision = builder.picosTimestampPrecision;
   }
 
+  /**
+   * <b>[Beta]</b> Returns the buffer compression algorithm (e.g., LZ4_FRAME, ZSTD, UNCOMPRESSED).
+   */
+  @BetaApi
   public String getBufferCompression() {
     return bufferCompression;
   }
 
+  /** <b>[Beta]</b> Returns the timestamp precision for Arrow timestamp types. */
+  @BetaApi
   public String getPicosTimestampPrecision() {
     return picosTimestampPrecision;
   }
 
+  /** <b>[Beta]</b> Returns a new builder for {@link ArrowSerializationOptions}. */
+  @BetaApi
   public static Builder newBuilder() {
     return new Builder();
   }
@@ -82,22 +90,32 @@ static ArrowSerializationOptions fromPb(
     return ArrowSerializationOptionsConverter.fromPb(optionsPb);
   }
 
+  /** <b>[Beta]</b> Builder for {@link ArrowSerializationOptions}. */
+  @BetaApi
   public static final class Builder {
     private String bufferCompression;
     private String picosTimestampPrecision;
 
     private Builder() {}
 
+    /**
+     * <b>[Beta]</b> Sets the buffer compression algorithm (e.g., LZ4_FRAME, ZSTD, UNCOMPRESSED).
+     */
+    @BetaApi
     public Builder setBufferCompression(String bufferCompression) {
       this.bufferCompression = bufferCompression;
       return this;
     }
 
+    /** <b>[Beta]</b> Sets the timestamp precision for Arrow timestamp types. */
+    @BetaApi
     public Builder setPicosTimestampPrecision(String picosTimestampPrecision) {
       this.picosTimestampPrecision = picosTimestampPrecision;
       return this;
     }
 
+    /** <b>[Beta]</b> Builds a new instance of {@link ArrowSerializationOptions}. */
+    @BetaApi
     public ArrowSerializationOptions build() {
       return new ArrowSerializationOptions(this);
     }

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

@@ -20,6 +20,7 @@
 import static com.google.common.base.Preconditions.checkNotNull;
 import static com.google.common.base.Strings.isNullOrEmpty;
 
+import com.google.api.core.BetaApi;
 import com.google.api.services.bigquery.model.JobConfigurationQuery;
 import com.google.api.services.bigquery.model.QueryParameter;
 import com.google.cloud.bigquery.JobInfo.CreateDisposition;
@@ -708,33 +709,34 @@ public Builder setReservation(String reservation) {
     }
 
     /**
-     * Sets the query results response format. Defaults to {@link
+     * <b>[Beta]</b> Sets the query results response format. Defaults to {@link
      * QueryResultsFormat#STRUCT_ENCODING}.
      *
      * <p>When set to {@link QueryResultsFormat#ARROW}, query results are returned in binary Apache
      * Arrow format, utilizing gRPC Storage Read streams for subsequent pages.
      *
      * <p><b>Prerequisite:</b> Requires the BigQuery Storage Read API ({@code
-     * bigquerystorage.googleapis.com}) to be enabled on your GCP project and your credentials to
-     * have Storage Read permissions (e.g. {@code bigquery.readsessions.create}).
+     * bigquerystorage.googleapis.com}) to be enabled on your GCP project.
      *
      * @param queryResultsFormat the format for query result payloads
      * @return the Builder
      */
+    @BetaApi
     public Builder setQueryResultsFormat(QueryResultsFormat queryResultsFormat) {
       this.queryResultsFormat = queryResultsFormat;
       return this;
     }
 
     /**
-     * Sets Arrow serialization options. Defaults to null.
+     * <b>[Beta]</b> Sets Arrow serialization options. Defaults to null.
      *
      * <p>Note: Only applied in the request payload when {@code queryResultsFormat} is {@code
      * ARROW}.
      *
      * @param arrowSerializationOptions the Arrow serialization options to set
      * @return the Builder
      */
+    @BetaApi
     public Builder setArrowSerializationOptions(
         ArrowSerializationOptions arrowSerializationOptions) {
       this.arrowSerializationOptions = arrowSerializationOptions;
@@ -1015,10 +1017,14 @@ public Builder toBuilder() {
     return new Builder(this);
   }
 
+  /** <b>[Beta]</b> Returns the query results response format. */
+  @BetaApi
   public QueryResultsFormat getQueryResultsFormat() {
     return queryResultsFormat;
   }
 
+  /** <b>[Beta]</b> Returns Arrow serialization options, or null if unset. */
+  @BetaApi
   public ArrowSerializationOptions getArrowSerializationOptions() {
     return arrowSerializationOptions;
   }

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

@@ -18,7 +18,7 @@
 
 import com.google.api.core.BetaApi;
 
-/** The format of the query results. */
+/** <b>[Beta]</b> The format of the query results. */
 @BetaApi
 public enum QueryResultsFormat {
   /** Serialized row data in Apache Arrow format. */