feat(bigquery): update the API

#### bigquery:v2

The following keys were added:
- schemas.Dataset.properties.linkedDatasetMetadata.$ref
- schemas.Dataset.properties.linkedDatasetMetadata.description
- schemas.Dataset.properties.linkedDatasetMetadata.readOnly
- schemas.LinkedDatasetMetadata.description
- schemas.LinkedDatasetMetadata.id
- schemas.LinkedDatasetMetadata.properties.linkState.description
- schemas.LinkedDatasetMetadata.properties.linkState.enum
- schemas.LinkedDatasetMetadata.properties.linkState.enumDescriptions
- schemas.LinkedDatasetMetadata.properties.linkState.readOnly
- schemas.LinkedDatasetMetadata.properties.linkState.type
- schemas.LinkedDatasetMetadata.type
- schemas.PartitionedColumn.description
- schemas.PartitionedColumn.id
- schemas.PartitionedColumn.properties.field.description
- schemas.PartitionedColumn.properties.field.readOnly
- schemas.PartitionedColumn.properties.field.type
- schemas.PartitionedColumn.type
- schemas.PartitioningDefinition.description
- schemas.PartitioningDefinition.id
- schemas.PartitioningDefinition.properties.partitionedColumn.description
- schemas.PartitioningDefinition.properties.partitionedColumn.items.$ref
- schemas.PartitioningDefinition.properties.partitionedColumn.readOnly
- schemas.PartitioningDefinition.properties.partitionedColumn.type
- schemas.PartitioningDefinition.type
- schemas.Table.properties.partitionDefinition.$ref
- schemas.Table.properties.partitionDefinition.description
- schemas.Table.properties.partitionDefinition.readOnly

The following keys were changed:
- schemas.SparkStatistics.properties.gcsStagingBucket.description
- schemas.SparkStatistics.properties.kmsKeyName.description
- schemas.TableFieldSchema.properties.rangeElementType.properties.type.description
- schemas.TableFieldSchema.properties.type.description

Author: yoshi-automation

discovery/bigquery-v2.json

@@ -1844,7 +1844,7 @@
       }
     }
   },
-  "revision": "20240211",
+  "revision": "20240229",
   "rootUrl": "https://bigquery.googleapis.com/",
   "schemas": {
     "AggregateClassificationMetrics": {
@@ -3140,6 +3140,11 @@
           "readOnly": true,
           "type": "string"
         },
+        "linkedDatasetMetadata": {
+          "$ref": "LinkedDatasetMetadata",
+          "description": "Output only. Metadata about the LinkedDataset. Filled out when the dataset type is LINKED.",
+          "readOnly": true
+        },
         "linkedDatasetSource": {
           "$ref": "LinkedDatasetSource",
           "description": "Optional. The source dataset reference when the dataset is of type LINKED. For all other dataset types it is not set. This field cannot be updated once it is set. Any attempt to update this field using Update and Patch API Operations will be ignored."
@@ -5776,6 +5781,28 @@
       "id": "JsonValue",
       "type": "any"
     },
+    "LinkedDatasetMetadata": {
+      "description": "Metadata about the Linked Dataset.",
+      "id": "LinkedDatasetMetadata",
+      "properties": {
+        "linkState": {
+          "description": "Output only. Specifies whether Linked Dataset is currently in a linked state or not.",
+          "enum": [
+            "LINK_STATE_UNSPECIFIED",
+            "LINKED",
+            "UNLINKED"
+          ],
+          "enumDescriptions": [
+            "The default value. Default to the LINKED state.",
+            "Normal Linked Dataset state. Data is queryable via the Linked Dataset.",
+            "Data publisher or owner has unlinked this Linked Dataset. It means you can no longer query or see the data in the Linked Dataset."
+          ],
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "LinkedDatasetSource": {
       "description": "A dataset source type which refers to another BigQuery dataset.",
       "id": "LinkedDatasetSource",
@@ -6407,6 +6434,33 @@
       },
       "type": "object"
     },
+    "PartitionedColumn": {
+      "description": "The partitioning column information.",
+      "id": "PartitionedColumn",
+      "properties": {
+        "field": {
+          "description": "Output only. The name of the partition column.",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "PartitioningDefinition": {
+      "description": "The partitioning information, which includes managed table and external table partition information.",
+      "id": "PartitioningDefinition",
+      "properties": {
+        "partitionedColumn": {
+          "description": "Output only. Details about each partitioning column. BigQuery native tables only support 1 partitioning column. Other table types may support 0, 1 or more partitioning columns.",
+          "items": {
+            "$ref": "PartitionedColumn"
+          },
+          "readOnly": true,
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "PerformanceInsights": {
       "description": "Performance insights for the job.",
       "id": "PerformanceInsights",
@@ -7608,12 +7662,12 @@
           "type": "object"
         },
         "gcsStagingBucket": {
-          "description": "Output only. The Google Cloud Storage bucket that is used as the default filesystem by the Spark application. This fields is only filled when the Spark procedure uses the INVOKER security mode. It is inferred from the system variable @@spark_proc_properties.staging_bucket if it is provided. Otherwise, BigQuery creates a default staging bucket for the job and returns the bucket name in this field. Example: * `gs://[bucket_name]`",
+          "description": "Output only. The Google Cloud Storage bucket that is used as the default file system by the Spark application. This field is only filled when the Spark procedure uses the invoker security mode. The `gcsStagingBucket` bucket is inferred from the `@@spark_proc_properties.staging_bucket` system variable (if it is provided). Otherwise, BigQuery creates a default staging bucket for the job and returns the bucket name in this field. Example: * `gs://[bucket_name]`",
           "readOnly": true,
           "type": "string"
         },
         "kmsKeyName": {
-          "description": "Output only. The Cloud KMS encryption key that is used to protect the resources created by the Spark job. If the Spark procedure uses DEFINER security mode, the Cloud KMS key is inferred from the Spark connection associated with the procedure if it is provided. Otherwise the key is inferred from the default key of the Spark connection's project if the CMEK organization policy is enforced. If the Spark procedure uses INVOKER security mode, the Cloud KMS encryption key is inferred from the system variable @@spark_proc_properties.kms_key_name if it is provided. Otherwise, the key is inferred fromt he default key of the BigQuery job's project if the CMEK organization policy is enforced. Example: * `projects/[kms_project_id]/locations/[region]/keyRings/[key_region]/cryptoKeys/[key]`",
+          "description": "Output only. The Cloud KMS encryption key that is used to protect the resources created by the Spark job. If the Spark procedure uses the invoker security mode, the Cloud KMS encryption key is either inferred from the provided system variable, `@@spark_proc_properties.kms_key_name`, or the default key of the BigQuery job's project (if the CMEK organization policy is enforced). Otherwise, the Cloud KMS key is either inferred from the Spark connection associated with the procedure (if it is provided), or from the default key of the Spark connection's project if the CMEK organization policy is enforced. Example: * `projects/[kms_project_id]/locations/[region]/keyRings/[key_region]/cryptoKeys/[key]`",
           "readOnly": true,
           "type": "string"
         },
@@ -8043,6 +8097,11 @@
           "readOnly": true,
           "type": "string"
         },
+        "partitionDefinition": {
+          "$ref": "PartitioningDefinition",
+          "description": "Output only. The partition information for all table formats, including managed partitioned tables, hive partitioned tables, and iceberg partitioned tables.",
+          "readOnly": true
+        },
         "rangePartitioning": {
           "$ref": "RangePartitioning",
           "description": "If specified, configures range partitioning for this table."
@@ -8370,7 +8429,7 @@
           "description": "Represents the type of a field element.",
           "properties": {
             "type": {
-              "description": "Required. The type of a field element. See TableFieldSchema.type.",
+              "description": "Required. The type of a field element. For more information, see TableFieldSchema.type.",
               "type": "string"
             }
           },
@@ -8396,7 +8455,7 @@
           "type": "string"
         },
         "type": {
-          "description": "Required. The field data type. Possible values include: * STRING * BYTES * INTEGER (or INT64) * FLOAT (or FLOAT64) * BOOLEAN (or BOOL) * TIMESTAMP * DATE * TIME * DATETIME * GEOGRAPHY * NUMERIC * BIGNUMERIC * JSON * RECORD (or STRUCT) Use of RECORD/STRUCT indicates that the field contains a nested schema.",
+          "description": "Required. The field data type. Possible values include: * STRING * BYTES * INTEGER (or INT64) * FLOAT (or FLOAT64) * BOOLEAN (or BOOL) * TIMESTAMP * DATE * TIME * DATETIME * GEOGRAPHY * NUMERIC * BIGNUMERIC * JSON * RECORD (or STRUCT) * RANGE ([Preview](/products/#product-launch-stages)) Use of RECORD/STRUCT indicates that the field contains a nested schema.",
           "type": "string"
         }
       },

src/apis/bigquery/v2.ts

@@ -943,6 +943,10 @@ export namespace bigquery_v2 {
      * Output only. The date when this dataset was last modified, in milliseconds since the epoch.
      */
     lastModifiedTime?: string | null;
+    /**
+     * Output only. Metadata about the LinkedDataset. Filled out when the dataset type is LINKED.
+     */
+    linkedDatasetMetadata?: Schema$LinkedDatasetMetadata;
     /**
      * Optional. The source dataset reference when the dataset is of type LINKED. For all other dataset types it is not set. This field cannot be updated once it is set. Any attempt to update this field using Update and Patch API Operations will be ignored.
      */
@@ -2803,6 +2807,15 @@ export namespace bigquery_v2 {
     encoding?: string | null;
   }
   export interface Schema$JsonValue {}
+  /**
+   * Metadata about the Linked Dataset.
+   */
+  export interface Schema$LinkedDatasetMetadata {
+    /**
+     * Output only. Specifies whether Linked Dataset is currently in a linked state or not.
+     */
+    linkState?: string | null;
+  }
   /**
    * A dataset source type which refers to another BigQuery dataset.
    */
@@ -3147,6 +3160,24 @@ export namespace bigquery_v2 {
      */
     enumAsString?: boolean | null;
   }
+  /**
+   * The partitioning column information.
+   */
+  export interface Schema$PartitionedColumn {
+    /**
+     * Output only. The name of the partition column.
+     */
+    field?: string | null;
+  }
+  /**
+   * The partitioning information, which includes managed table and external table partition information.
+   */
+  export interface Schema$PartitioningDefinition {
+    /**
+     * Output only. Details about each partitioning column. BigQuery native tables only support 1 partitioning column. Other table types may support 0, 1 or more partitioning columns.
+     */
+    partitionedColumn?: Schema$PartitionedColumn[];
+  }
   /**
    * Performance insights for the job.
    */
@@ -3958,11 +3989,11 @@ export namespace bigquery_v2 {
      */
     endpoints?: {[key: string]: string} | null;
     /**
-     * Output only. The Google Cloud Storage bucket that is used as the default filesystem by the Spark application. This fields is only filled when the Spark procedure uses the INVOKER security mode. It is inferred from the system variable @@spark_proc_properties.staging_bucket if it is provided. Otherwise, BigQuery creates a default staging bucket for the job and returns the bucket name in this field. Example: * `gs://[bucket_name]`
+     * Output only. The Google Cloud Storage bucket that is used as the default file system by the Spark application. This field is only filled when the Spark procedure uses the invoker security mode. The `gcsStagingBucket` bucket is inferred from the `@@spark_proc_properties.staging_bucket` system variable (if it is provided). Otherwise, BigQuery creates a default staging bucket for the job and returns the bucket name in this field. Example: * `gs://[bucket_name]`
      */
     gcsStagingBucket?: string | null;
     /**
-     * Output only. The Cloud KMS encryption key that is used to protect the resources created by the Spark job. If the Spark procedure uses DEFINER security mode, the Cloud KMS key is inferred from the Spark connection associated with the procedure if it is provided. Otherwise the key is inferred from the default key of the Spark connection's project if the CMEK organization policy is enforced. If the Spark procedure uses INVOKER security mode, the Cloud KMS encryption key is inferred from the system variable @@spark_proc_properties.kms_key_name if it is provided. Otherwise, the key is inferred fromt he default key of the BigQuery job's project if the CMEK organization policy is enforced. Example: * `projects/[kms_project_id]/locations/[region]/keyRings/[key_region]/cryptoKeys/[key]`
+     * Output only. The Cloud KMS encryption key that is used to protect the resources created by the Spark job. If the Spark procedure uses the invoker security mode, the Cloud KMS encryption key is either inferred from the provided system variable, `@@spark_proc_properties.kms_key_name`, or the default key of the BigQuery job's project (if the CMEK organization policy is enforced). Otherwise, the Cloud KMS key is either inferred from the Spark connection associated with the procedure (if it is provided), or from the default key of the Spark connection's project if the CMEK organization policy is enforced. Example: * `projects/[kms_project_id]/locations/[region]/keyRings/[key_region]/cryptoKeys/[key]`
      */
     kmsKeyName?: string | null;
     /**
@@ -4237,6 +4268,10 @@ export namespace bigquery_v2 {
      * Output only. The physical size of this table in bytes. This also includes storage used for time travel. This data is not kept in real time, and might be delayed by a few seconds to a few minutes.
      */
     numTotalPhysicalBytes?: string | null;
+    /**
+     * Output only. The partition information for all table formats, including managed partitioned tables, hive partitioned tables, and iceberg partitioned tables.
+     */
+    partitionDefinition?: Schema$PartitioningDefinition;
     /**
      * If specified, configures range partitioning for this table.
      */
@@ -4439,7 +4474,7 @@ export namespace bigquery_v2 {
      */
     scale?: string | null;
     /**
-     * Required. The field data type. Possible values include: * STRING * BYTES * INTEGER (or INT64) * FLOAT (or FLOAT64) * BOOLEAN (or BOOL) * TIMESTAMP * DATE * TIME * DATETIME * GEOGRAPHY * NUMERIC * BIGNUMERIC * JSON * RECORD (or STRUCT) Use of RECORD/STRUCT indicates that the field contains a nested schema.
+     * Required. The field data type. Possible values include: * STRING * BYTES * INTEGER (or INT64) * FLOAT (or FLOAT64) * BOOLEAN (or BOOL) * TIMESTAMP * DATE * TIME * DATETIME * GEOGRAPHY * NUMERIC * BIGNUMERIC * JSON * RECORD (or STRUCT) * RANGE ([Preview](/products/#product-launch-stages)) Use of RECORD/STRUCT indicates that the field contains a nested schema.
      */
     type?: string | null;
   }