docs: Add docstring for classes and fields that are not supported in Gemini or Vertex API

PiperOrigin-RevId: 822252117

Author: jaycee-li

src/main/java/com/google/genai/types/ApiAuth.java

@@ -27,7 +27,8 @@
 
 /**
  * The generic reusable api auth config. Deprecated. Please use AuthConfig
- * (google/cloud/aiplatform/master/auth.proto) instead.
+ * (google/cloud/aiplatform/master/auth.proto) instead. This data type is not supported in Gemini
+ * API.
  */
 @AutoValue
 @JsonDeserialize(builder = ApiAuth.Builder.class)

src/main/java/com/google/genai/types/ApiAuthApiKeyConfig.java

@@ -25,7 +25,7 @@
 import com.google.genai.JsonSerializable;
 import java.util.Optional;
 
-/** The API secret. */
+/** The API secret. This data type is not supported in Gemini API. */
 @AutoValue
 @JsonDeserialize(builder = ApiAuthApiKeyConfig.Builder.class)
 public abstract class ApiAuthApiKeyConfig extends JsonSerializable {

src/main/java/com/google/genai/types/AuthConfigGoogleServiceAccountConfig.java

@@ -25,7 +25,9 @@
 import com.google.genai.JsonSerializable;
 import java.util.Optional;
 
-/** Config for Google Service Account Authentication. */
+/**
+ * Config for Google Service Account Authentication. This data type is not supported in Gemini API.
+ */
 @AutoValue
 @JsonDeserialize(builder = AuthConfigGoogleServiceAccountConfig.Builder.class)
 public abstract class AuthConfigGoogleServiceAccountConfig extends JsonSerializable {

src/main/java/com/google/genai/types/AuthConfigHttpBasicAuthConfig.java

@@ -25,7 +25,7 @@
 import com.google.genai.JsonSerializable;
 import java.util.Optional;
 
-/** Config for HTTP Basic Authentication. */
+/** Config for HTTP Basic Authentication. This data type is not supported in Gemini API. */
 @AutoValue
 @JsonDeserialize(builder = AuthConfigHttpBasicAuthConfig.Builder.class)
 public abstract class AuthConfigHttpBasicAuthConfig extends JsonSerializable {

src/main/java/com/google/genai/types/AuthConfigOauthConfig.java

@@ -25,7 +25,7 @@
 import com.google.genai.JsonSerializable;
 import java.util.Optional;
 
-/** Config for user oauth. */
+/** Config for user oauth. This data type is not supported in Gemini API. */
 @AutoValue
 @JsonDeserialize(builder = AuthConfigOauthConfig.Builder.class)
 public abstract class AuthConfigOauthConfig extends JsonSerializable {

src/main/java/com/google/genai/types/AuthConfigOidcConfig.java

@@ -25,7 +25,7 @@
 import com.google.genai.JsonSerializable;
 import java.util.Optional;
 
-/** Config for user OIDC auth. */
+/** Config for user OIDC auth. This data type is not supported in Gemini API. */
 @AutoValue
 @JsonDeserialize(builder = AuthConfigOidcConfig.Builder.class)
 public abstract class AuthConfigOidcConfig extends JsonSerializable {

src/main/java/com/google/genai/types/BlockedReason.java

@@ -49,10 +49,13 @@ public enum Known {
     /** The prompt was blocked because it contains content that is unsafe for image generation. */
     IMAGE_SAFETY,
 
-    /** The prompt was blocked by Model Armor. */
+    /** The prompt was blocked by Model Armor. This enum value is not supported in Gemini API. */
     MODEL_ARMOR,
 
-    /** The prompt was blocked as a jailbreak attempt. */
+    /**
+     * The prompt was blocked as a jailbreak attempt. This enum value is not supported in Gemini
+     * API.
+     */
     JAILBREAK
   }
 

src/main/java/com/google/genai/types/CachedContentUsageMetadata.java

@@ -29,23 +29,23 @@
 @AutoValue
 @JsonDeserialize(builder = CachedContentUsageMetadata.Builder.class)
 public abstract class CachedContentUsageMetadata extends JsonSerializable {
-  /** Duration of audio in seconds. */
+  /** Duration of audio in seconds. This field is not supported in Gemini API. */
   @JsonProperty("audioDurationSeconds")
   public abstract Optional<Integer> audioDurationSeconds();
 
-  /** Number of images. */
+  /** Number of images. This field is not supported in Gemini API. */
   @JsonProperty("imageCount")
   public abstract Optional<Integer> imageCount();
 
-  /** Number of text characters. */
+  /** Number of text characters. This field is not supported in Gemini API. */
   @JsonProperty("textCount")
   public abstract Optional<Integer> textCount();
 
   /** Total number of tokens that the cached content consumes. */
   @JsonProperty("totalTokenCount")
   public abstract Optional<Integer> totalTokenCount();
 
-  /** Duration of video in seconds. */
+  /** Duration of video in seconds. This field is not supported in Gemini API. */
   @JsonProperty("videoDurationSeconds")
   public abstract Optional<Integer> videoDurationSeconds();
 
@@ -70,23 +70,24 @@ private static Builder create() {
     /**
      * Setter for audioDurationSeconds.
      *
-     * <p>audioDurationSeconds: Duration of audio in seconds.
+     * <p>audioDurationSeconds: Duration of audio in seconds. This field is not supported in Gemini
+     * API.
      */
     @JsonProperty("audioDurationSeconds")
     public abstract Builder audioDurationSeconds(Integer audioDurationSeconds);
 
     /**
      * Setter for imageCount.
      *
-     * <p>imageCount: Number of images.
+     * <p>imageCount: Number of images. This field is not supported in Gemini API.
      */
     @JsonProperty("imageCount")
     public abstract Builder imageCount(Integer imageCount);
 
     /**
      * Setter for textCount.
      *
-     * <p>textCount: Number of text characters.
+     * <p>textCount: Number of text characters. This field is not supported in Gemini API.
      */
     @JsonProperty("textCount")
     public abstract Builder textCount(Integer textCount);
@@ -102,7 +103,8 @@ private static Builder create() {
     /**
      * Setter for videoDurationSeconds.
      *
-     * <p>videoDurationSeconds: Duration of video in seconds.
+     * <p>videoDurationSeconds: Duration of video in seconds. This field is not supported in Gemini
+     * API.
      */
     @JsonProperty("videoDurationSeconds")
     public abstract Builder videoDurationSeconds(Integer videoDurationSeconds);

src/main/java/com/google/genai/types/Citation.java

@@ -25,7 +25,7 @@
 import com.google.genai.JsonSerializable;
 import java.util.Optional;
 
-/** Source attributions for content. */
+/** Source attributions for content. This data type is not supported in Gemini API. */
 @AutoValue
 @JsonDeserialize(builder = Citation.Builder.class)
 public abstract class Citation extends JsonSerializable {

src/main/java/com/google/genai/types/DatasetDistribution.java

@@ -29,7 +29,7 @@
 import java.util.List;
 import java.util.Optional;
 
-/** Distribution computed over a tuning dataset. */
+/** Distribution computed over a tuning dataset. This data type is not supported in Gemini API. */
 @AutoValue
 @JsonDeserialize(builder = DatasetDistribution.Builder.class)
 public abstract class DatasetDistribution extends JsonSerializable {