chore: Update data types from discovery doc.

PiperOrigin-RevId: 832486480

Author: jscud

Google.GenAI/LiveConverters.cs

@@ -0,0 +1,62 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Auto-generated code. Do not edit.
+
+using System.Text.Json.Serialization;
+
+namespace Google.GenAI.Types {
+  /// <summary>
+  /// Output only. The state of the batch. This enum is not supported in Vertex AI.
+  /// </summary>
+  [JsonConverter(typeof(JsonStringEnumConverter))]
+  public enum BatchState {
+    /// <summary>
+    /// The batch state is unspecified.
+    /// </summary>
+    [JsonPropertyName("BATCH_STATE_UNSPECIFIED")] BATCH_STATE_UNSPECIFIED,
+
+    /// <summary>
+    /// The service is preparing to run the batch.
+    /// </summary>
+    [JsonPropertyName("BATCH_STATE_PENDING")] BATCH_STATE_PENDING,
+
+    /// <summary>
+    /// The batch is in progress.
+    /// </summary>
+    [JsonPropertyName("BATCH_STATE_RUNNING")] BATCH_STATE_RUNNING,
+
+    /// <summary>
+    /// The batch completed successfully.
+    /// </summary>
+    [JsonPropertyName("BATCH_STATE_SUCCEEDED")] BATCH_STATE_SUCCEEDED,
+
+    /// <summary>
+    /// The batch failed.
+    /// </summary>
+    [JsonPropertyName("BATCH_STATE_FAILED")] BATCH_STATE_FAILED,
+
+    /// <summary>
+    /// The batch has been cancelled.
+    /// </summary>
+    [JsonPropertyName("BATCH_STATE_CANCELLED")] BATCH_STATE_CANCELLED,
+
+    /// <summary>
+    /// The batch has expired.
+    /// </summary>
+    [JsonPropertyName("BATCH_STATE_EXPIRED")] BATCH_STATE_EXPIRED
+  }
+}

Google.GenAI/Models.cs

@@ -23,22 +23,23 @@
 
 namespace Google.GenAI.Types {
   /// <summary>
-  /// Content blob.
+  /// A content blob. A Blob contains data of a specific media type. It is used to represent images,
+  /// audio, and video.
   /// </summary>
 
   public record Blob {
     /// <summary>
-    /// Raw bytes.
+    /// The raw bytes of the data.
     /// </summary>
     [JsonPropertyName("data")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public byte[] ? Data { get; set; }
 
     /// <summary>
-    /// Optional. Display name of the blob. Used to provide a label or filename to distinguish
-    /// blobs. This field is only returned in PromptMessage for prompt management. It is currently
-    /// used in the Gemini GenerateContent calls only when server side tools (code_execution,
-    /// google_search, and url_context) are enabled. This field is not supported in Gemini API.
+    /// Optional. The display name of the blob. Used to provide a label or filename to distinguish
+    /// blobs. This field is only returned in `PromptMessage` for prompt management. It is used in
+    /// the Gemini calls only when server-side tools (`code_execution`, `google_search`, and
+    /// `url_context`) are enabled. This field is not supported in Gemini API.
     /// </summary>
     [JsonPropertyName("displayName")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]

Google.GenAI/types/BatchState.cs

@@ -76,7 +76,9 @@ public FinishReason
           }
 
     /// <summary>
-    /// Output only. Average log probability score of the candidate.
+    /// Output only. The average log probability of the tokens in this candidate. This is a
+    /// length-normalized score that can be used to compare the quality of candidates of different
+    /// lengths. A higher average log probability suggests a more confident and coherent response.
     /// </summary>
     [JsonPropertyName("avgLogprobs")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
@@ -86,7 +88,8 @@ public double
           }
 
     /// <summary>
-    /// Output only. Metadata specifies sources used to ground generated content.
+    /// Output only. Metadata returned when grounding is enabled. It contains the sources used to
+    /// ground the generated content.
     /// </summary>
     [JsonPropertyName("groundingMetadata")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
@@ -96,7 +99,8 @@ public GroundingMetadata
           }
 
     /// <summary>
-    /// Output only. Index of the candidate.
+    /// Output only. The 0-based index of this candidate in the list of generated responses. This is
+    /// useful for distinguishing between multiple candidates when `candidate_count` > 1.
     /// </summary>
     [JsonPropertyName("index")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
@@ -106,7 +110,9 @@ public int
           }
 
     /// <summary>
-    /// Output only. Log-likelihood scores for the response tokens and top tokens
+    /// Output only. The detailed log probability information for the tokens in this candidate. This
+    /// is useful for debugging, understanding model uncertainty, and identifying potential
+    /// "hallucinations".
     /// </summary>
     [JsonPropertyName("logprobsResult")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
@@ -116,7 +122,7 @@ public LogprobsResult
           }
 
     /// <summary>
-    /// Output only. List of ratings for the safety of a response candidate. There is at most one
+    /// Output only. A list of ratings for the safety of a response candidate. There is at most one
     /// rating per category.
     /// </summary>
     [JsonPropertyName("safetyRatings")]
@@ -127,7 +133,8 @@ public List<SafetyRating>
           }
 
     /// <summary>
-    /// Output only. Metadata related to url context retrieval tool.
+    /// Output only. Metadata returned when the model uses the `url_context` tool to get information
+    /// from a user-provided URL.
     /// </summary>
     [JsonPropertyName("urlContextMetadata")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]

Google.GenAI/types/Blob.cs

@@ -23,19 +23,19 @@
 
 namespace Google.GenAI.Types {
   /// <summary>
-  /// Source attributions for content. This data type is not supported in Gemini API.
+  /// A citation for a piece of generatedcontent. This data type is not supported in Gemini API.
   /// </summary>
 
   public record Citation {
     /// <summary>
-    /// Output only. End index into the content.
+    /// Output only. The end index of the citation in the content.
     /// </summary>
     [JsonPropertyName("endIndex")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public int ? EndIndex { get; set; }
 
     /// <summary>
-    /// Output only. License of the attribution.
+    /// Output only. The license of the source of the citation.
     /// </summary>
     [JsonPropertyName("license")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
@@ -45,7 +45,7 @@ public string
           }
 
     /// <summary>
-    /// Output only. Publication date of the attribution.
+    /// Output only. The publication date of the source of the citation.
     /// </summary>
     [JsonPropertyName("publicationDate")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
@@ -55,7 +55,7 @@ public GoogleTypeDate
           }
 
     /// <summary>
-    /// Output only. Start index into the content.
+    /// Output only. The start index of the citation in the content.
     /// </summary>
     [JsonPropertyName("startIndex")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
@@ -65,7 +65,7 @@ public int
           }
 
     /// <summary>
-    /// Output only. Title of the attribution.
+    /// Output only. The title of the source of the citation.
     /// </summary>
     [JsonPropertyName("title")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
@@ -75,7 +75,7 @@ public string
           }
 
     /// <summary>
-    /// Output only. Url reference of the attribution.
+    /// Output only. The URI of the source of the citation.
     /// </summary>
     [JsonPropertyName("uri")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]

Google.GenAI/types/Candidate.cs

@@ -36,8 +36,8 @@ public record Content {
     public List<Part> ? Parts { get; set; }
 
     /// <summary>
-    /// Optional. The producer of the content. Must be either 'user' or 'model'. Useful to set for
-    /// multi-turn conversations, otherwise can be left blank or unset.
+    /// Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the
+    /// service will default to 'user'.
     /// </summary>
     [JsonPropertyName("role")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]

Google.GenAI/types/Citation.cs

@@ -44,6 +44,118 @@ public EmbedContentConfig
             get; set;
           }
 
+    /// <summary>
+    /// Output only. Stats about the batch.
+    /// </summary>
+    [JsonPropertyName("batchStats")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public EmbedContentBatchStats
+        ? BatchStats {
+            get; set;
+          }
+
+    /// <summary>
+    /// Output only. The time at which the batch was created.
+    /// </summary>
+    [JsonPropertyName("createTime")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public DateTime
+        ? CreateTime {
+            get; set;
+          }
+
+    /// <summary>
+    /// The user-defined name of this batch.
+    /// </summary>
+    [JsonPropertyName("displayName")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string
+        ? DisplayName {
+            get; set;
+          }
+
+    /// <summary>
+    /// Output only. The time at which the batch processing completed.
+    /// </summary>
+    [JsonPropertyName("endTime")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public DateTime
+        ? EndTime {
+            get; set;
+          }
+
+    /// <summary>
+    /// Input configuration of the instances on which batch processing are performed.
+    /// </summary>
+    [JsonPropertyName("inputConfig")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public InputEmbedContentConfig
+        ? InputConfig {
+            get; set;
+          }
+
+    /// <summary>
+    /// The name of the `Model` to use for generating the completion. Format: `models/{model}`.
+    /// </summary>
+    [JsonPropertyName("model")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string
+        ? Model {
+            get; set;
+          }
+
+    /// <summary>
+    /// Output only. Identifier. Resource name of the batch. Format: `batches/{batch_id}`.
+    /// </summary>
+    [JsonPropertyName("name")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string
+        ? Name {
+            get; set;
+          }
+
+    /// <summary>
+    /// Output only. The output of the batch request.
+    /// </summary>
+    [JsonPropertyName("output")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public EmbedContentBatchOutput
+        ? Output {
+            get; set;
+          }
+
+    /// <summary>
+    /// Optional. The priority of the batch. Batches with a higher priority value will be processed
+    /// before batches with a lower priority value. Negative values are allowed. Default is 0.
+    /// </summary>
+    [JsonPropertyName("priority")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    [JsonConverter(typeof(StringToNullableLongConverter))]
+    public long
+        ? Priority {
+            get; set;
+          }
+
+    /// <summary>
+    /// Output only. The state of the batch.
+    /// </summary>
+    [JsonPropertyName("state")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public BatchState
+        ? State {
+            get; set;
+          }
+
+    /// <summary>
+    /// Output only. The time at which the batch was last updated.
+    /// </summary>
+    [JsonPropertyName("updateTime")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public DateTime
+        ? UpdateTime {
+            get; set;
+          }
+
     /// <summary>
     /// Deserializes a JSON string to a EmbedContentBatch object.
     /// </summary>