feat: Automated regeneration of BigQuery client (googleapis#12766)

Auto-created at 2025-01-04 13:14:22 +0000 using the toys pull request generator.

Author: yoshi-code-bot

clients/big_query/lib/google_api/big_query/v2/api/jobs.ex

@@ -45,7 +45,7 @@ defmodule GoogleApi.BigQuery.V2.Api.Jobs do
       *   `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:location` (*type:* `String.t`) - The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see https://cloud.google.com/bigquery/docs/locations#specifying_your_location.
+      *   `:location` (*type:* `String.t`) - The geographic location of the job. You must [specify the location](https://cloud.google.com/bigquery/docs/locations#specify_locations) to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`)
   *   `opts` (*type:* `keyword()`) - Call options
 
   ## Returns
@@ -109,7 +109,7 @@ defmodule GoogleApi.BigQuery.V2.Api.Jobs do
       *   `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:location` (*type:* `String.t`) - The geographic location of the job. Required. See details at: https://cloud.google.com/bigquery/docs/locations#specifying_your_location.
+      *   `:location` (*type:* `String.t`) - The geographic location of the job. Required. For more information, see how to [specify locations](https://cloud.google.com/bigquery/docs/locations#specify_locations).
   *   `opts` (*type:* `keyword()`) - Call options
 
   ## Returns
@@ -170,7 +170,7 @@ defmodule GoogleApi.BigQuery.V2.Api.Jobs do
       *   `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:location` (*type:* `String.t`) - The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see https://cloud.google.com/bigquery/docs/locations#specifying_your_location.
+      *   `:location` (*type:* `String.t`) - The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see how to [specify locations](https://cloud.google.com/bigquery/docs/locations#specify_locations).
   *   `opts` (*type:* `keyword()`) - Call options
 
   ## Returns
@@ -235,7 +235,7 @@ defmodule GoogleApi.BigQuery.V2.Api.Jobs do
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
       *   `:"formatOptions.useInt64Timestamp"` (*type:* `boolean()`) - Optional. Output timestamp as usec int64. Default is false.
-      *   `:location` (*type:* `String.t`) - The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see https://cloud.google.com/bigquery/docs/locations#specifying_your_location.
+      *   `:location` (*type:* `String.t`) - The geographic location of the job. You must specify the location to run the job for the following scenarios: * If the location to run a job is not in the `us` or the `eu` multi-regional location * If the job's location is in a single region (for example, `us-central1`) For more information, see how to [specify locations](https://cloud.google.com/bigquery/docs/locations#specify_locations).
       *   `:maxResults` (*type:* `integer()`) - Maximum number of results to read.
       *   `:pageToken` (*type:* `String.t`) - Page token, returned by a previous call, to request the next page of results.
       *   `:startIndex` (*type:* `String.t`) - Zero-based index of the starting row.

clients/big_query/lib/google_api/big_query/v2/metadata.ex

@@ -20,7 +20,7 @@ defmodule GoogleApi.BigQuery.V2 do
   API client metadata for GoogleApi.BigQuery.V2.
   """
 
-  @discovery_revision "20241115"
+  @discovery_revision "20241222"
 
   def discovery_revision(), do: @discovery_revision
 end

clients/big_query/lib/google_api/big_query/v2/model/clustering.ex

@@ -21,7 +21,7 @@ defmodule GoogleApi.BigQuery.V2.Model.Clustering do
 
   ## Attributes
 
-  *   `fields` (*type:* `list(String.t)`, *default:* `nil`) - One or more fields on which data should be clustered. Only top-level, non-repeated, simple-type fields are supported. The ordering of the clustering fields should be prioritized from most to least important for filtering purposes. Additional information on limitations can be found here: https://cloud.google.com/bigquery/docs/creating-clustered-tables#limitations
+  *   `fields` (*type:* `list(String.t)`, *default:* `nil`) - One or more fields on which data should be clustered. Only top-level, non-repeated, simple-type fields are supported. The ordering of the clustering fields should be prioritized from most to least important for filtering purposes. For additional information, see [Introduction to clustered tables](https://cloud.google.com/bigquery/docs/clustered-tables#limitations).
   """
 
   use GoogleApi.Gax.ModelBase

clients/big_query/lib/google_api/big_query/v2/model/external_catalog_dataset_options.ex

@@ -17,12 +17,12 @@
 
 defmodule GoogleApi.BigQuery.V2.Model.ExternalCatalogDatasetOptions do
   @moduledoc """
-  Options defining open source compatible datasets living in the BigQuery catalog. Contains metadata of open source database, schema or namespace represented by the current dataset.
+  Options defining open source compatible datasets living in the BigQuery catalog. Contains metadata of open source database, schema, or namespace represented by the current dataset.
 
   ## Attributes
 
   *   `defaultStorageLocationUri` (*type:* `String.t`, *default:* `nil`) - Optional. The storage location URI for all tables in the dataset. Equivalent to hive metastore's database locationUri. Maximum length of 1024 characters.
-  *   `parameters` (*type:* `map()`, *default:* `nil`) - Optional. A map of key value pairs defining the parameters and properties of the open source schema. Maximum size of 2Mib.
+  *   `parameters` (*type:* `map()`, *default:* `nil`) - Optional. A map of key value pairs defining the parameters and properties of the open source schema. Maximum size of 2MiB.
   """
 
   use GoogleApi.Gax.ModelBase

clients/big_query/lib/google_api/big_query/v2/model/external_catalog_table_options.ex

@@ -17,12 +17,12 @@
 
 defmodule GoogleApi.BigQuery.V2.Model.ExternalCatalogTableOptions do
   @moduledoc """
-  Metadata about open source compatible table. The fields contained in these options correspond to hive metastore's table level properties.
+  Metadata about open source compatible table. The fields contained in these options correspond to Hive metastore's table-level properties.
 
   ## Attributes
 
-  *   `connectionId` (*type:* `String.t`, *default:* `nil`) - Optional. The connection specifying the credentials to be used to read external storage, such as Azure Blob, Cloud Storage, or S3. The connection is needed to read the open source table from BigQuery Engine. The connection_id can have the form `..` or `projects//locations//connections/`.
-  *   `parameters` (*type:* `map()`, *default:* `nil`) - Optional. A map of key value pairs defining the parameters and properties of the open source table. Corresponds with hive meta store table parameters. Maximum size of 4Mib.
+  *   `connectionId` (*type:* `String.t`, *default:* `nil`) - Optional. A connection ID that specifies the credentials to be used to read external storage, such as Azure Blob, Cloud Storage, or Amazon S3. This connection is needed to read the open source table from BigQuery. The connection_id format must be either `..` or `projects//locations//connections/`.
+  *   `parameters` (*type:* `map()`, *default:* `nil`) - Optional. A map of the key-value pairs defining the parameters and properties of the open source table. Corresponds with Hive metastore table parameters. Maximum size of 4MiB.
   *   `storageDescriptor` (*type:* `GoogleApi.BigQuery.V2.Model.StorageDescriptor.t`, *default:* `nil`) - Optional. A storage descriptor containing information about the physical storage of this table.
   """