feat(bigquery): update the API

#### bigquery:v2

The following keys were added:
- resources.datasets.methods.patch.parameters.updateMode.description
- resources.datasets.methods.patch.parameters.updateMode.enum
- resources.datasets.methods.patch.parameters.updateMode.enumDescriptions
- resources.datasets.methods.patch.parameters.updateMode.location
- resources.datasets.methods.patch.parameters.updateMode.type
- resources.datasets.methods.update.parameters.updateMode.description
- resources.datasets.methods.update.parameters.updateMode.enum
- resources.datasets.methods.update.parameters.updateMode.enumDescriptions
- resources.datasets.methods.update.parameters.updateMode.location
- resources.datasets.methods.update.parameters.updateMode.type
- schemas.QueryTimelineSample.properties.shuffleRamUsageRatio.description
- schemas.QueryTimelineSample.properties.shuffleRamUsageRatio.format
- schemas.QueryTimelineSample.properties.shuffleRamUsageRatio.type

The following keys were changed:
- resources.datasets.methods.get.parameters.datasetView.enumDescriptions
- schemas.JobConfigurationLoad.properties.timeZone.description
- schemas.JobStatistics2.properties.referencedTables.description

Author: yoshi-automation

discovery/bigquery-v2.json

@@ -276,9 +276,9 @@
               ],
               "enumDescriptions": [
                 "The default value. Default to the FULL view.",
-                "Includes metadata information for the dataset, such as location, etag, lastModifiedTime, etc.",
-                "Includes ACL information for the dataset, which defines dataset access for one or more entities.",
-                "Includes both dataset metadata and ACL information."
+                "Updates metadata information for the dataset, such as friendlyName, description, labels, etc.",
+                "Updates ACL information for the dataset, which defines dataset access for one or more entities.",
+                "Updates both dataset metadata and ACL information."
               ],
               "location": "query",
               "type": "string"
@@ -413,6 +413,23 @@
               "pattern": "^[^/]+$",
               "required": true,
               "type": "string"
+            },
+            "updateMode": {
+              "description": "Optional. Specifies the fields of dataset that update/patch operation is targeting By default, both metadata and ACL fields are updated.",
+              "enum": [
+                "UPDATE_MODE_UNSPECIFIED",
+                "UPDATE_METADATA",
+                "UPDATE_ACL",
+                "UPDATE_FULL"
+              ],
+              "enumDescriptions": [
+                "The default value. Default to the UPDATE_FULL.",
+                "Includes metadata information for the dataset, such as friendlyName, description, labels, etc.",
+                "Includes ACL information for the dataset, which defines dataset access for one or more entities.",
+                "Includes both dataset metadata and ACL information."
+              ],
+              "location": "query",
+              "type": "string"
             }
           },
           "path": "projects/{+projectId}/datasets/{+datasetId}",
@@ -493,6 +510,23 @@
               "pattern": "^[^/]+$",
               "required": true,
               "type": "string"
+            },
+            "updateMode": {
+              "description": "Optional. Specifies the fields of dataset that update/patch operation is targeting By default, both metadata and ACL fields are updated.",
+              "enum": [
+                "UPDATE_MODE_UNSPECIFIED",
+                "UPDATE_METADATA",
+                "UPDATE_ACL",
+                "UPDATE_FULL"
+              ],
+              "enumDescriptions": [
+                "The default value. Default to the UPDATE_FULL.",
+                "Includes metadata information for the dataset, such as friendlyName, description, labels, etc.",
+                "Includes ACL information for the dataset, which defines dataset access for one or more entities.",
+                "Includes both dataset metadata and ACL information."
+              ],
+              "location": "query",
+              "type": "string"
             }
           },
           "path": "projects/{+projectId}/datasets/{+datasetId}",
@@ -2256,7 +2290,7 @@
       }
     }
   },
-  "revision": "20250404",
+  "revision": "20250427",
   "rootUrl": "https://bigquery.googleapis.com/",
   "schemas": {
     "AggregateClassificationMetrics": {
@@ -5577,7 +5611,7 @@
           "description": "Time-based partitioning specification for the destination table. Only one of timePartitioning and rangePartitioning should be specified."
         },
         "timeZone": {
-          "description": "Optional. [Experimental] Default time zone that will apply when parsing timestamp values that have no specific time zone.",
+          "description": "Optional. Default time zone that will apply when parsing timestamp values that have no specific time zone.",
           "type": "string"
         },
         "timestampFormat": {
@@ -6235,7 +6269,7 @@
           "type": "array"
         },
         "referencedTables": {
-          "description": "Output only. Referenced tables for the job. Queries that reference more than 50 tables will not have a complete list.",
+          "description": "Output only. Referenced tables for the job.",
           "items": {
             "$ref": "TableReference"
           },
@@ -7780,6 +7814,11 @@
           "format": "int64",
           "type": "string"
         },
+        "shuffleRamUsageRatio": {
+          "description": "Total shuffle usage ratio in shuffle RAM per reservation of this query. This will be provided for reservation customers only.",
+          "format": "double",
+          "type": "number"
+        },
         "totalSlotMs": {
           "description": "Cumulative slot-ms consumed by the query.",
           "format": "int64",

src/apis/bigquery/v2.ts

@@ -2423,7 +2423,7 @@ export namespace bigquery_v2 {
      */
     timestampFormat?: string | null;
     /**
-     * Optional. [Experimental] Default time zone that will apply when parsing timestamp values that have no specific time zone.
+     * Optional. Default time zone that will apply when parsing timestamp values that have no specific time zone.
      */
     timeZone?: string | null;
     /**
@@ -2865,7 +2865,7 @@ export namespace bigquery_v2 {
      */
     referencedRoutines?: Schema$RoutineReference[];
     /**
-     * Output only. Referenced tables for the job. Queries that reference more than 50 tables will not have a complete list.
+     * Output only. Referenced tables for the job.
      */
     referencedTables?: Schema$TableReference[];
     /**
@@ -3808,6 +3808,10 @@ export namespace bigquery_v2 {
      * Total units of work remaining for the query. This number can be revised (increased or decreased) while the query is running.
      */
     pendingUnits?: string | null;
+    /**
+     * Total shuffle usage ratio in shuffle RAM per reservation of this query. This will be provided for reservation customers only.
+     */
+    shuffleRamUsageRatio?: number | null;
     /**
      * Cumulative slot-ms consumed by the query.
      */
@@ -6242,6 +6246,10 @@ export namespace bigquery_v2 {
      * Required. Project ID of the dataset being updated
      */
     projectId?: string;
+    /**
+     * Optional. Specifies the fields of dataset that update/patch operation is targeting By default, both metadata and ACL fields are updated.
+     */
+    updateMode?: string;
 
     /**
      * Request body metadata
@@ -6277,6 +6285,10 @@ export namespace bigquery_v2 {
      * Required. Project ID of the dataset being updated
      */
     projectId?: string;
+    /**
+     * Optional. Specifies the fields of dataset that update/patch operation is targeting By default, both metadata and ACL fields are updated.
+     */
+    updateMode?: string;
 
     /**
      * Request body metadata