google-cloud-bigquery-v2 0.1.1

// 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.
//
// Code generated by sidekick. DO NOT EDIT.
#![allow(rustdoc::bare_urls)]
#![allow(rustdoc::broken_intra_doc_links)]
#![allow(rustdoc::invalid_html_tags)]
#![allow(rustdoc::redundant_explicit_links)]

/// Implements a client for the BigQuery API.
///
/// # Example
/// ```
/// # use google_cloud_bigquery_v2::client::DatasetService;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = DatasetService::builder().build().await?;
///     let response = client.get_dataset()
///         /* set fields */
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// DatasetService provides methods for managing BigQuery datasets.
///
/// # Configuration
///
/// To configure `DatasetService` use the `with_*` methods in the type returned
/// by [builder()][DatasetService::builder]. The default configuration should
/// work for most applications. Common configuration changes include
///
/// * [with_endpoint()]: by default this client uses the global default endpoint
///   (`https://bigquery.googleapis.com`). Applications using regional
///   endpoints or running in restricted networks (e.g. a network configured
///   with [Private Google Access with VPC Service Controls]) may want to
///   override this default.
/// * [with_credentials()]: by default this client uses
///   [Application Default Credentials]. Applications using custom
///   authentication may need to override this default.
///
/// [with_endpoint()]: super::builder::dataset_service::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::dataset_service::ClientBuilder::with_credentials
/// [Private Google Access with VPC Service Controls]: https://cloud.google.com/vpc-service-controls/docs/private-connectivity
/// [Application Default Credentials]: https://cloud.google.com/docs/authentication#adc
///
/// # Pooling and Cloning
///
/// `DatasetService` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `DatasetService` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[derive(Clone, Debug)]
pub struct DatasetService {
    inner: std::sync::Arc<dyn super::stub::dynamic::DatasetService>,
}

impl DatasetService {
    /// Returns a builder for [DatasetService].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_bigquery_v2::client::DatasetService;
    /// let client = DatasetService::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::dataset_service::ClientBuilder {
        crate::new_client_builder(super::builder::dataset_service::client::Factory)
    }

    /// Creates a new client from the provided stub.
    ///
    /// The most common case for calling this function is in tests mocking the
    /// client's behavior.
    pub fn from_stub<T>(stub: impl Into<std::sync::Arc<T>>) -> Self
    where
        T: super::stub::DatasetService + 'static,
    {
        Self { inner: stub.into() }
    }

    pub(crate) async fn new(
        config: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<Self> {
        let inner = Self::build_inner(config).await?;
        Ok(Self { inner })
    }

    async fn build_inner(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<std::sync::Arc<dyn super::stub::dynamic::DatasetService>> {
        if gaxi::options::tracing_enabled(&conf) {
            return Ok(std::sync::Arc::new(Self::build_with_tracing(conf).await?));
        }
        Ok(std::sync::Arc::new(Self::build_transport(conf).await?))
    }

    async fn build_transport(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::DatasetService> {
        super::transport::DatasetService::new(conf).await
    }

    async fn build_with_tracing(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::DatasetService> {
        Self::build_transport(conf)
            .await
            .map(super::tracing::DatasetService::new)
    }

    /// Returns the dataset specified by datasetID.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.datasets.get` permission on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::DatasetService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &DatasetService
    /// ) -> Result<()> {
    ///     let response = client.get_dataset()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_dataset(&self) -> super::builder::dataset_service::GetDataset {
        super::builder::dataset_service::GetDataset::new(self.inner.clone())
    }

    /// Creates a new empty dataset.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.datasets.create` permission on the project.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::DatasetService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &DatasetService
    /// ) -> Result<()> {
    ///     let response = client.insert_dataset()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn insert_dataset(&self) -> super::builder::dataset_service::InsertDataset {
        super::builder::dataset_service::InsertDataset::new(self.inner.clone())
    }

    /// Updates information in an existing dataset. The update method replaces the
    /// entire dataset resource, whereas the patch method only replaces fields that
    /// are provided in the submitted dataset resource.
    /// This method supports RFC5789 patch semantics.
    ///
    /// # IAM Permissions
    ///
    /// Requires the following IAM permission(s) to use this method:
    ///
    /// - `bigquery.datasets.update` on the dataset.
    /// - `bigquery.datasets.get` on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::DatasetService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &DatasetService
    /// ) -> Result<()> {
    ///     let response = client.patch_dataset()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn patch_dataset(&self) -> super::builder::dataset_service::PatchDataset {
        super::builder::dataset_service::PatchDataset::new(self.inner.clone())
    }

    /// Updates information in an existing dataset. The update method replaces the
    /// entire dataset resource, whereas the patch method only replaces fields that
    /// are provided in the submitted dataset resource.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.datasets.update` permission on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::DatasetService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &DatasetService
    /// ) -> Result<()> {
    ///     let response = client.update_dataset()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_dataset(&self) -> super::builder::dataset_service::UpdateDataset {
        super::builder::dataset_service::UpdateDataset::new(self.inner.clone())
    }

    /// Deletes the dataset specified by the datasetId value. Before you can delete
    /// a dataset, you must delete all its tables, either manually or by specifying
    /// deleteContents. Immediately after deletion, you can create another dataset
    /// with the same name.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.datasets.delete` permission on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::DatasetService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &DatasetService
    /// ) -> Result<()> {
    ///     client.delete_dataset()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_dataset(&self) -> super::builder::dataset_service::DeleteDataset {
        super::builder::dataset_service::DeleteDataset::new(self.inner.clone())
    }

    /// Lists all datasets in the specified project to which the user has been
    /// granted the READER dataset role.
    ///
    /// # IAM Permissions
    ///
    /// Requires no specific IAM permission(s) to use this method.
    /// Results are filtered to only include datasets on which the caller has the
    /// `bigquery.datasets.get` permission.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::DatasetService;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &DatasetService
    /// ) -> Result<()> {
    ///     let mut list = client.list_datasets()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_datasets(&self) -> super::builder::dataset_service::ListDatasets {
        super::builder::dataset_service::ListDatasets::new(self.inner.clone())
    }

    /// Undeletes a dataset which is within time travel window based on datasetId.
    /// If a time is specified, the dataset version deleted at that time is
    /// undeleted, else the last live version is undeleted.
    ///
    /// # IAM Permissions
    ///
    /// Requires the following IAM permission(s) to use this method:
    ///
    /// - `bigquery.datasets.create` on the project.
    /// - `bigquery.datasets.get` on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::DatasetService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &DatasetService
    /// ) -> Result<()> {
    ///     let response = client.undelete_dataset()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn undelete_dataset(&self) -> super::builder::dataset_service::UndeleteDataset {
        super::builder::dataset_service::UndeleteDataset::new(self.inner.clone())
    }
}

/// Implements a client for the BigQuery API.
///
/// # Example
/// ```
/// # use google_cloud_bigquery_v2::client::JobService;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = JobService::builder().build().await?;
///     let response = client.cancel_job()
///         /* set fields */
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
///
/// # Configuration
///
/// To configure `JobService` use the `with_*` methods in the type returned
/// by [builder()][JobService::builder]. The default configuration should
/// work for most applications. Common configuration changes include
///
/// * [with_endpoint()]: by default this client uses the global default endpoint
///   (`https://bigquery.googleapis.com`). Applications using regional
///   endpoints or running in restricted networks (e.g. a network configured
///   with [Private Google Access with VPC Service Controls]) may want to
///   override this default.
/// * [with_credentials()]: by default this client uses
///   [Application Default Credentials]. Applications using custom
///   authentication may need to override this default.
///
/// [with_endpoint()]: super::builder::job_service::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::job_service::ClientBuilder::with_credentials
/// [Private Google Access with VPC Service Controls]: https://cloud.google.com/vpc-service-controls/docs/private-connectivity
/// [Application Default Credentials]: https://cloud.google.com/docs/authentication#adc
///
/// # Pooling and Cloning
///
/// `JobService` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `JobService` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[derive(Clone, Debug)]
pub struct JobService {
    inner: std::sync::Arc<dyn super::stub::dynamic::JobService>,
}

impl JobService {
    /// Returns a builder for [JobService].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_bigquery_v2::client::JobService;
    /// let client = JobService::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::job_service::ClientBuilder {
        crate::new_client_builder(super::builder::job_service::client::Factory)
    }

    /// Creates a new client from the provided stub.
    ///
    /// The most common case for calling this function is in tests mocking the
    /// client's behavior.
    pub fn from_stub<T>(stub: impl Into<std::sync::Arc<T>>) -> Self
    where
        T: super::stub::JobService + 'static,
    {
        Self { inner: stub.into() }
    }

    pub(crate) async fn new(
        config: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<Self> {
        let inner = Self::build_inner(config).await?;
        Ok(Self { inner })
    }

    async fn build_inner(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<std::sync::Arc<dyn super::stub::dynamic::JobService>> {
        if gaxi::options::tracing_enabled(&conf) {
            return Ok(std::sync::Arc::new(Self::build_with_tracing(conf).await?));
        }
        Ok(std::sync::Arc::new(Self::build_transport(conf).await?))
    }

    async fn build_transport(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::JobService> {
        super::transport::JobService::new(conf).await
    }

    async fn build_with_tracing(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::JobService> {
        Self::build_transport(conf)
            .await
            .map(super::tracing::JobService::new)
    }

    /// Requests that a job be cancelled. This call will return immediately, and
    /// the client will need to poll for the job status to see if the cancel
    /// completed successfully. Cancelled jobs may still incur costs.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.jobs.update` permission on the job resource.
    /// If the user matches the creator of the job, the `bigquery.jobs.create`
    /// permission on the project is required instead.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::JobService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &JobService
    /// ) -> Result<()> {
    ///     let response = client.cancel_job()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_job(&self) -> super::builder::job_service::CancelJob {
        super::builder::job_service::CancelJob::new(self.inner.clone())
    }

    /// Returns information about a specific job. Job information is available for
    /// a six month period after creation. Requires that you're the person who ran
    /// the job, or have the Is Owner project role.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.jobs.get` permission on the job resource.
    /// If the user matches the creator of the job, the `bigquery.jobs.create`
    /// permission on the project is required instead.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::JobService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &JobService
    /// ) -> Result<()> {
    ///     let response = client.get_job()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_job(&self) -> super::builder::job_service::GetJob {
        super::builder::job_service::GetJob::new(self.inner.clone())
    }

    /// Starts a new asynchronous job.
    ///
    /// This API has two different kinds of endpoint URIs, as this method supports
    /// a variety of use cases.
    ///
    /// * The *Metadata* URI is used for most interactions, as it accepts the job
    ///   configuration directly.
    /// * The *Upload* URI is ONLY for the case when you're sending both a load job
    ///   configuration and a data stream together.  In this case, the Upload URI
    ///   accepts the job configuration and the data as two distinct multipart MIME
    ///   parts.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.jobs.create` permission on the project resource.
    ///
    /// Additional permissions are required depending on the job type:
    ///
    /// - **Load, Export, and Copy jobs**: Generally require data-level
    ///   permissions such as `bigquery.tables.export` or access to external
    ///   storage.
    /// - **Query jobs**: Permissions are dependent on the SQL statement.
    ///   Complex queries (DDL, DCL) may require additional permissions to
    ///   create reservations, modify IAM policies, or update project settings.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::JobService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &JobService
    /// ) -> Result<()> {
    ///     let response = client.insert_job()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn insert_job(&self) -> super::builder::job_service::InsertJob {
        super::builder::job_service::InsertJob::new(self.inner.clone())
    }

    /// Requests the deletion of the metadata of a job. This call returns when the
    /// job's metadata is deleted.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.jobs.delete` permission on the job resource.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::JobService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &JobService
    /// ) -> Result<()> {
    ///     client.delete_job()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_job(&self) -> super::builder::job_service::DeleteJob {
        super::builder::job_service::DeleteJob::new(self.inner.clone())
    }

    /// Lists all jobs that you started in the specified project. Job information
    /// is available for a six month period after creation. The job list is sorted
    /// in reverse chronological order, by job creation time. Requires the Can View
    /// project role, or the Is Owner project role if you set the allUsers
    /// property.
    ///
    /// # IAM Permissions
    ///
    /// Requires no specific IAM permission(s) to use this method. Users are able
    /// to list the jobs they created.
    ///
    /// Additional access is granted based on the following permissions:
    ///
    /// - Users with the `bigquery.jobs.listAll` permission can list all jobs with
    ///   all metadata.
    /// - Users with the `bigquery.jobs.list` permission can list all jobs, but
    ///   with redacted information for jobs they did not create.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::JobService;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &JobService
    /// ) -> Result<()> {
    ///     let mut list = client.list_jobs()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_jobs(&self) -> super::builder::job_service::ListJobs {
        super::builder::job_service::ListJobs::new(self.inner.clone())
    }

    /// RPC to get the results of a query job.
    ///
    /// # IAM Permissions
    ///
    /// Requires the following IAM permission(s) to use this method:
    ///
    /// - `bigquery.jobs.get` on the job.
    /// - `bigquery.tables.getData` on the destination table.
    ///
    /// If the user matches the creator of the job, the following IAM permission(s)
    /// are required instead:
    ///
    /// - `bigquery.jobs.create` on the project.
    /// - `bigquery.tables.getData` on the destination table.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::JobService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &JobService
    /// ) -> Result<()> {
    ///     let response = client.get_query_results()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_query_results(&self) -> super::builder::job_service::GetQueryResults {
        super::builder::job_service::GetQueryResults::new(self.inner.clone())
    }

    /// Runs a BigQuery SQL query synchronously and returns query results if the
    /// query completes within a specified timeout.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.jobs.create` permission on the project resource.
    ///
    /// Data-level permissions are highly dependent on the SQL statement being
    /// executed. While standard queries require data access (such as
    /// `bigquery.tables.getData`), complex operations like DDL or DCL may require
    /// permissions to manage reservations, IAM policies, or project settings.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::JobService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &JobService
    /// ) -> Result<()> {
    ///     let response = client.query()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn query(&self) -> super::builder::job_service::Query {
        super::builder::job_service::Query::new(self.inner.clone())
    }
}

/// Implements a client for the BigQuery API.
///
/// # Example
/// ```
/// # use google_cloud_bigquery_v2::client::ModelService;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = ModelService::builder().build().await?;
///     let response = client.get_model()
///         /* set fields */
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Model Service for BigQuery ML
///
/// # Configuration
///
/// To configure `ModelService` use the `with_*` methods in the type returned
/// by [builder()][ModelService::builder]. The default configuration should
/// work for most applications. Common configuration changes include
///
/// * [with_endpoint()]: by default this client uses the global default endpoint
///   (`https://bigquery.googleapis.com`). Applications using regional
///   endpoints or running in restricted networks (e.g. a network configured
///   with [Private Google Access with VPC Service Controls]) may want to
///   override this default.
/// * [with_credentials()]: by default this client uses
///   [Application Default Credentials]. Applications using custom
///   authentication may need to override this default.
///
/// [with_endpoint()]: super::builder::model_service::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::model_service::ClientBuilder::with_credentials
/// [Private Google Access with VPC Service Controls]: https://cloud.google.com/vpc-service-controls/docs/private-connectivity
/// [Application Default Credentials]: https://cloud.google.com/docs/authentication#adc
///
/// # Pooling and Cloning
///
/// `ModelService` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `ModelService` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[derive(Clone, Debug)]
pub struct ModelService {
    inner: std::sync::Arc<dyn super::stub::dynamic::ModelService>,
}

impl ModelService {
    /// Returns a builder for [ModelService].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_bigquery_v2::client::ModelService;
    /// let client = ModelService::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::model_service::ClientBuilder {
        crate::new_client_builder(super::builder::model_service::client::Factory)
    }

    /// Creates a new client from the provided stub.
    ///
    /// The most common case for calling this function is in tests mocking the
    /// client's behavior.
    pub fn from_stub<T>(stub: impl Into<std::sync::Arc<T>>) -> Self
    where
        T: super::stub::ModelService + 'static,
    {
        Self { inner: stub.into() }
    }

    pub(crate) async fn new(
        config: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<Self> {
        let inner = Self::build_inner(config).await?;
        Ok(Self { inner })
    }

    async fn build_inner(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<std::sync::Arc<dyn super::stub::dynamic::ModelService>> {
        if gaxi::options::tracing_enabled(&conf) {
            return Ok(std::sync::Arc::new(Self::build_with_tracing(conf).await?));
        }
        Ok(std::sync::Arc::new(Self::build_transport(conf).await?))
    }

    async fn build_transport(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::ModelService> {
        super::transport::ModelService::new(conf).await
    }

    async fn build_with_tracing(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::ModelService> {
        Self::build_transport(conf)
            .await
            .map(super::tracing::ModelService::new)
    }

    /// Gets the specified model resource by model ID.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.models.getMetadata` permission on the model.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::ModelService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &ModelService
    /// ) -> Result<()> {
    ///     let response = client.get_model()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_model(&self) -> super::builder::model_service::GetModel {
        super::builder::model_service::GetModel::new(self.inner.clone())
    }

    /// Lists all models in the specified dataset. Requires the READER dataset
    /// role. After retrieving the list of models, you can get information about a
    /// particular model by calling the models.get method.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.models.list` permission on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::ModelService;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &ModelService
    /// ) -> Result<()> {
    ///     let mut list = client.list_models()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_models(&self) -> super::builder::model_service::ListModels {
        super::builder::model_service::ListModels::new(self.inner.clone())
    }

    /// Patch specific fields in the specified model.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.models.updateMetadata` permission on the model.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::ModelService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &ModelService
    /// ) -> Result<()> {
    ///     let response = client.patch_model()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn patch_model(&self) -> super::builder::model_service::PatchModel {
        super::builder::model_service::PatchModel::new(self.inner.clone())
    }

    /// Deletes the model specified by modelId from the dataset.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.models.delete` permission on the model.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::ModelService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &ModelService
    /// ) -> Result<()> {
    ///     client.delete_model()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_model(&self) -> super::builder::model_service::DeleteModel {
        super::builder::model_service::DeleteModel::new(self.inner.clone())
    }
}

/// Implements a client for the BigQuery API.
///
/// # Example
/// ```
/// # use google_cloud_bigquery_v2::client::ProjectService;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = ProjectService::builder().build().await?;
///     let response = client.get_service_account()
///         /* set fields */
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// This service provides access to BigQuery functionality related to projects.
///
/// # Configuration
///
/// To configure `ProjectService` use the `with_*` methods in the type returned
/// by [builder()][ProjectService::builder]. The default configuration should
/// work for most applications. Common configuration changes include
///
/// * [with_endpoint()]: by default this client uses the global default endpoint
///   (`https://bigquery.googleapis.com`). Applications using regional
///   endpoints or running in restricted networks (e.g. a network configured
///   with [Private Google Access with VPC Service Controls]) may want to
///   override this default.
/// * [with_credentials()]: by default this client uses
///   [Application Default Credentials]. Applications using custom
///   authentication may need to override this default.
///
/// [with_endpoint()]: super::builder::project_service::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::project_service::ClientBuilder::with_credentials
/// [Private Google Access with VPC Service Controls]: https://cloud.google.com/vpc-service-controls/docs/private-connectivity
/// [Application Default Credentials]: https://cloud.google.com/docs/authentication#adc
///
/// # Pooling and Cloning
///
/// `ProjectService` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `ProjectService` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[derive(Clone, Debug)]
pub struct ProjectService {
    inner: std::sync::Arc<dyn super::stub::dynamic::ProjectService>,
}

impl ProjectService {
    /// Returns a builder for [ProjectService].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_bigquery_v2::client::ProjectService;
    /// let client = ProjectService::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::project_service::ClientBuilder {
        crate::new_client_builder(super::builder::project_service::client::Factory)
    }

    /// Creates a new client from the provided stub.
    ///
    /// The most common case for calling this function is in tests mocking the
    /// client's behavior.
    pub fn from_stub<T>(stub: impl Into<std::sync::Arc<T>>) -> Self
    where
        T: super::stub::ProjectService + 'static,
    {
        Self { inner: stub.into() }
    }

    pub(crate) async fn new(
        config: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<Self> {
        let inner = Self::build_inner(config).await?;
        Ok(Self { inner })
    }

    async fn build_inner(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<std::sync::Arc<dyn super::stub::dynamic::ProjectService>> {
        if gaxi::options::tracing_enabled(&conf) {
            return Ok(std::sync::Arc::new(Self::build_with_tracing(conf).await?));
        }
        Ok(std::sync::Arc::new(Self::build_transport(conf).await?))
    }

    async fn build_transport(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::ProjectService> {
        super::transport::ProjectService::new(conf).await
    }

    async fn build_with_tracing(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::ProjectService> {
        Self::build_transport(conf)
            .await
            .map(super::tracing::ProjectService::new)
    }

    /// RPC to get the service account for a project used for interactions with
    /// Google Cloud KMS. Requires the `bigquery.jobs.create` permission on the
    /// project resource. This permission is required to authorize the retrieval
    /// of the project's service identity for technical management tasks like
    /// encryption configuration.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::ProjectService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &ProjectService
    /// ) -> Result<()> {
    ///     let response = client.get_service_account()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_service_account(&self) -> super::builder::project_service::GetServiceAccount {
        super::builder::project_service::GetServiceAccount::new(self.inner.clone())
    }
}

/// Implements a client for the BigQuery API.
///
/// # Example
/// ```
/// # use google_cloud_bigquery_v2::client::RoutineService;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = RoutineService::builder().build().await?;
///     let response = client.get_routine()
///         /* set fields */
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// RoutineService provides management access to BigQuery routines.
///
/// # Configuration
///
/// To configure `RoutineService` use the `with_*` methods in the type returned
/// by [builder()][RoutineService::builder]. The default configuration should
/// work for most applications. Common configuration changes include
///
/// * [with_endpoint()]: by default this client uses the global default endpoint
///   (`https://bigquery.googleapis.com`). Applications using regional
///   endpoints or running in restricted networks (e.g. a network configured
///   with [Private Google Access with VPC Service Controls]) may want to
///   override this default.
/// * [with_credentials()]: by default this client uses
///   [Application Default Credentials]. Applications using custom
///   authentication may need to override this default.
///
/// [with_endpoint()]: super::builder::routine_service::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::routine_service::ClientBuilder::with_credentials
/// [Private Google Access with VPC Service Controls]: https://cloud.google.com/vpc-service-controls/docs/private-connectivity
/// [Application Default Credentials]: https://cloud.google.com/docs/authentication#adc
///
/// # Pooling and Cloning
///
/// `RoutineService` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `RoutineService` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[derive(Clone, Debug)]
pub struct RoutineService {
    inner: std::sync::Arc<dyn super::stub::dynamic::RoutineService>,
}

impl RoutineService {
    /// Returns a builder for [RoutineService].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_bigquery_v2::client::RoutineService;
    /// let client = RoutineService::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::routine_service::ClientBuilder {
        crate::new_client_builder(super::builder::routine_service::client::Factory)
    }

    /// Creates a new client from the provided stub.
    ///
    /// The most common case for calling this function is in tests mocking the
    /// client's behavior.
    pub fn from_stub<T>(stub: impl Into<std::sync::Arc<T>>) -> Self
    where
        T: super::stub::RoutineService + 'static,
    {
        Self { inner: stub.into() }
    }

    pub(crate) async fn new(
        config: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<Self> {
        let inner = Self::build_inner(config).await?;
        Ok(Self { inner })
    }

    async fn build_inner(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<std::sync::Arc<dyn super::stub::dynamic::RoutineService>> {
        if gaxi::options::tracing_enabled(&conf) {
            return Ok(std::sync::Arc::new(Self::build_with_tracing(conf).await?));
        }
        Ok(std::sync::Arc::new(Self::build_transport(conf).await?))
    }

    async fn build_transport(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::RoutineService> {
        super::transport::RoutineService::new(conf).await
    }

    async fn build_with_tracing(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::RoutineService> {
        Self::build_transport(conf)
            .await
            .map(super::tracing::RoutineService::new)
    }

    /// Gets the specified routine resource by routine ID.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.routines.get` permission on the routine.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RoutineService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RoutineService
    /// ) -> Result<()> {
    ///     let response = client.get_routine()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_routine(&self) -> super::builder::routine_service::GetRoutine {
        super::builder::routine_service::GetRoutine::new(self.inner.clone())
    }

    /// Creates a new routine in the dataset.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.routines.create` permission on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RoutineService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RoutineService
    /// ) -> Result<()> {
    ///     let response = client.insert_routine()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn insert_routine(&self) -> super::builder::routine_service::InsertRoutine {
        super::builder::routine_service::InsertRoutine::new(self.inner.clone())
    }

    /// Updates information in an existing routine. The update method replaces the
    /// entire Routine resource.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.routines.update` permission on the routine.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RoutineService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RoutineService
    /// ) -> Result<()> {
    ///     let response = client.update_routine()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_routine(&self) -> super::builder::routine_service::UpdateRoutine {
        super::builder::routine_service::UpdateRoutine::new(self.inner.clone())
    }

    /// Deletes the routine specified by routineId from the dataset.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.routines.delete` permission on the routine.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RoutineService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RoutineService
    /// ) -> Result<()> {
    ///     client.delete_routine()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_routine(&self) -> super::builder::routine_service::DeleteRoutine {
        super::builder::routine_service::DeleteRoutine::new(self.inner.clone())
    }

    /// Lists all routines in the specified dataset. Requires the READER dataset
    /// role.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.routines.list` permission on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RoutineService;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RoutineService
    /// ) -> Result<()> {
    ///     let mut list = client.list_routines()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_routines(&self) -> super::builder::routine_service::ListRoutines {
        super::builder::routine_service::ListRoutines::new(self.inner.clone())
    }
}

/// Implements a client for the BigQuery API.
///
/// # Example
/// ```
/// # use google_cloud_bigquery_v2::client::RowAccessPolicyService;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = RowAccessPolicyService::builder().build().await?;
///     let response = client.get_row_access_policy()
///         /* set fields */
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for interacting with row access policies.
///
/// # Configuration
///
/// To configure `RowAccessPolicyService` use the `with_*` methods in the type returned
/// by [builder()][RowAccessPolicyService::builder]. The default configuration should
/// work for most applications. Common configuration changes include
///
/// * [with_endpoint()]: by default this client uses the global default endpoint
///   (`https://bigquery.googleapis.com`). Applications using regional
///   endpoints or running in restricted networks (e.g. a network configured
///   with [Private Google Access with VPC Service Controls]) may want to
///   override this default.
/// * [with_credentials()]: by default this client uses
///   [Application Default Credentials]. Applications using custom
///   authentication may need to override this default.
///
/// [with_endpoint()]: super::builder::row_access_policy_service::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::row_access_policy_service::ClientBuilder::with_credentials
/// [Private Google Access with VPC Service Controls]: https://cloud.google.com/vpc-service-controls/docs/private-connectivity
/// [Application Default Credentials]: https://cloud.google.com/docs/authentication#adc
///
/// # Pooling and Cloning
///
/// `RowAccessPolicyService` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `RowAccessPolicyService` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[derive(Clone, Debug)]
pub struct RowAccessPolicyService {
    inner: std::sync::Arc<dyn super::stub::dynamic::RowAccessPolicyService>,
}

impl RowAccessPolicyService {
    /// Returns a builder for [RowAccessPolicyService].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_bigquery_v2::client::RowAccessPolicyService;
    /// let client = RowAccessPolicyService::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::row_access_policy_service::ClientBuilder {
        crate::new_client_builder(super::builder::row_access_policy_service::client::Factory)
    }

    /// Creates a new client from the provided stub.
    ///
    /// The most common case for calling this function is in tests mocking the
    /// client's behavior.
    pub fn from_stub<T>(stub: impl Into<std::sync::Arc<T>>) -> Self
    where
        T: super::stub::RowAccessPolicyService + 'static,
    {
        Self { inner: stub.into() }
    }

    pub(crate) async fn new(
        config: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<Self> {
        let inner = Self::build_inner(config).await?;
        Ok(Self { inner })
    }

    async fn build_inner(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<std::sync::Arc<dyn super::stub::dynamic::RowAccessPolicyService>>
    {
        if gaxi::options::tracing_enabled(&conf) {
            return Ok(std::sync::Arc::new(Self::build_with_tracing(conf).await?));
        }
        Ok(std::sync::Arc::new(Self::build_transport(conf).await?))
    }

    async fn build_transport(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::RowAccessPolicyService> {
        super::transport::RowAccessPolicyService::new(conf).await
    }

    async fn build_with_tracing(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::RowAccessPolicyService> {
        Self::build_transport(conf)
            .await
            .map(super::tracing::RowAccessPolicyService::new)
    }

    /// Lists all row access policies on the specified table.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.rowAccessPolicies.list` permission on the table.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RowAccessPolicyService;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RowAccessPolicyService
    /// ) -> Result<()> {
    ///     let mut list = client.list_row_access_policies()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_row_access_policies(
        &self,
    ) -> super::builder::row_access_policy_service::ListRowAccessPolicies {
        super::builder::row_access_policy_service::ListRowAccessPolicies::new(self.inner.clone())
    }

    /// Gets the specified row access policy by policy ID.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.rowAccessPolicies.get` permission on the table.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RowAccessPolicyService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RowAccessPolicyService
    /// ) -> Result<()> {
    ///     let response = client.get_row_access_policy()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_row_access_policy(
        &self,
    ) -> super::builder::row_access_policy_service::GetRowAccessPolicy {
        super::builder::row_access_policy_service::GetRowAccessPolicy::new(self.inner.clone())
    }

    /// Creates a row access policy.
    ///
    /// # IAM Permissions
    ///
    /// Requires the following IAM permission(s) on the table:
    ///
    /// - `bigquery.rowAccessPolicies.create`
    /// - `bigquery.rowAccessPolicies.setIamPolicy`
    /// - `bigquery.tables.getData`
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RowAccessPolicyService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RowAccessPolicyService
    /// ) -> Result<()> {
    ///     let response = client.create_row_access_policy()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_row_access_policy(
        &self,
    ) -> super::builder::row_access_policy_service::CreateRowAccessPolicy {
        super::builder::row_access_policy_service::CreateRowAccessPolicy::new(self.inner.clone())
    }

    /// Updates a row access policy.
    ///
    /// # IAM Permissions
    ///
    /// Requires the following IAM permission(s) on the table:
    ///
    /// - `bigquery.rowAccessPolicies.update`
    /// - `bigquery.rowAccessPolicies.setIamPolicy`
    /// - `bigquery.tables.getData`
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RowAccessPolicyService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RowAccessPolicyService
    /// ) -> Result<()> {
    ///     let response = client.update_row_access_policy()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_row_access_policy(
        &self,
    ) -> super::builder::row_access_policy_service::UpdateRowAccessPolicy {
        super::builder::row_access_policy_service::UpdateRowAccessPolicy::new(self.inner.clone())
    }

    /// Deletes a row access policy.
    ///
    /// # IAM Permissions
    ///
    /// Requires the following IAM permission(s) on the table:
    ///
    /// - `bigquery.rowAccessPolicies.delete`
    /// - `bigquery.rowAccessPolicies.setIamPolicy`
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RowAccessPolicyService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RowAccessPolicyService
    /// ) -> Result<()> {
    ///     client.delete_row_access_policy()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_row_access_policy(
        &self,
    ) -> super::builder::row_access_policy_service::DeleteRowAccessPolicy {
        super::builder::row_access_policy_service::DeleteRowAccessPolicy::new(self.inner.clone())
    }

    /// Deletes provided row access policies.
    ///
    /// # IAM Permissions
    ///
    /// Requires the following IAM permission(s) on the table:
    ///
    /// - `bigquery.rowAccessPolicies.delete`
    /// - `bigquery.rowAccessPolicies.setIamPolicy`
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::RowAccessPolicyService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &RowAccessPolicyService
    /// ) -> Result<()> {
    ///     client.batch_delete_row_access_policies()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn batch_delete_row_access_policies(
        &self,
    ) -> super::builder::row_access_policy_service::BatchDeleteRowAccessPolicies {
        super::builder::row_access_policy_service::BatchDeleteRowAccessPolicies::new(
            self.inner.clone(),
        )
    }
}

/// Implements a client for the BigQuery API.
///
/// # Example
/// ```
/// # use google_cloud_bigquery_v2::client::TableService;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = TableService::builder().build().await?;
///     let response = client.get_table()
///         /* set fields */
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// TableService provides methods for managing BigQuery tables and table-like
/// entities such as views and snapshots.
///
/// # Configuration
///
/// To configure `TableService` use the `with_*` methods in the type returned
/// by [builder()][TableService::builder]. The default configuration should
/// work for most applications. Common configuration changes include
///
/// * [with_endpoint()]: by default this client uses the global default endpoint
///   (`https://bigquery.googleapis.com`). Applications using regional
///   endpoints or running in restricted networks (e.g. a network configured
///   with [Private Google Access with VPC Service Controls]) may want to
///   override this default.
/// * [with_credentials()]: by default this client uses
///   [Application Default Credentials]. Applications using custom
///   authentication may need to override this default.
///
/// [with_endpoint()]: super::builder::table_service::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::table_service::ClientBuilder::with_credentials
/// [Private Google Access with VPC Service Controls]: https://cloud.google.com/vpc-service-controls/docs/private-connectivity
/// [Application Default Credentials]: https://cloud.google.com/docs/authentication#adc
///
/// # Pooling and Cloning
///
/// `TableService` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `TableService` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[derive(Clone, Debug)]
pub struct TableService {
    inner: std::sync::Arc<dyn super::stub::dynamic::TableService>,
}

impl TableService {
    /// Returns a builder for [TableService].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_bigquery_v2::client::TableService;
    /// let client = TableService::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::table_service::ClientBuilder {
        crate::new_client_builder(super::builder::table_service::client::Factory)
    }

    /// Creates a new client from the provided stub.
    ///
    /// The most common case for calling this function is in tests mocking the
    /// client's behavior.
    pub fn from_stub<T>(stub: impl Into<std::sync::Arc<T>>) -> Self
    where
        T: super::stub::TableService + 'static,
    {
        Self { inner: stub.into() }
    }

    pub(crate) async fn new(
        config: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<Self> {
        let inner = Self::build_inner(config).await?;
        Ok(Self { inner })
    }

    async fn build_inner(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<std::sync::Arc<dyn super::stub::dynamic::TableService>> {
        if gaxi::options::tracing_enabled(&conf) {
            return Ok(std::sync::Arc::new(Self::build_with_tracing(conf).await?));
        }
        Ok(std::sync::Arc::new(Self::build_transport(conf).await?))
    }

    async fn build_transport(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::TableService> {
        super::transport::TableService::new(conf).await
    }

    async fn build_with_tracing(
        conf: gaxi::options::ClientConfig,
    ) -> crate::ClientBuilderResult<impl super::stub::TableService> {
        Self::build_transport(conf)
            .await
            .map(super::tracing::TableService::new)
    }

    /// Gets the specified table resource by table ID.
    /// This method does not return the data in the table, it only returns the
    /// table resource, which describes the structure of this table.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.tables.get` permission on the table.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::TableService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &TableService
    /// ) -> Result<()> {
    ///     let response = client.get_table()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_table(&self) -> super::builder::table_service::GetTable {
        super::builder::table_service::GetTable::new(self.inner.clone())
    }

    /// Creates a new, empty table in the dataset.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.tables.create` permission on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::TableService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &TableService
    /// ) -> Result<()> {
    ///     let response = client.insert_table()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn insert_table(&self) -> super::builder::table_service::InsertTable {
        super::builder::table_service::InsertTable::new(self.inner.clone())
    }

    /// Updates information in an existing table. The update method replaces the
    /// entire table resource, whereas the patch method only replaces fields that
    /// are provided in the submitted table resource.
    /// This method supports RFC5789 patch semantics.
    ///
    /// # IAM Permissions
    ///
    /// Requires the following IAM permission(s) on the table:
    ///
    /// - `bigquery.tables.update`
    /// - `bigquery.tables.get`
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::TableService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &TableService
    /// ) -> Result<()> {
    ///     let response = client.patch_table()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn patch_table(&self) -> super::builder::table_service::PatchTable {
        super::builder::table_service::PatchTable::new(self.inner.clone())
    }

    /// Updates information in an existing table. The update method replaces the
    /// entire Table resource, whereas the patch method only replaces fields that
    /// are provided in the submitted Table resource.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.tables.update` permission on the table.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::TableService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &TableService
    /// ) -> Result<()> {
    ///     let response = client.update_table()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_table(&self) -> super::builder::table_service::UpdateTable {
        super::builder::table_service::UpdateTable::new(self.inner.clone())
    }

    /// Deletes the table specified by tableId from the dataset.
    /// If the table contains data, all the data will be deleted.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.tables.delete` permission on the table.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::TableService;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &TableService
    /// ) -> Result<()> {
    ///     client.delete_table()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_table(&self) -> super::builder::table_service::DeleteTable {
        super::builder::table_service::DeleteTable::new(self.inner.clone())
    }

    /// Lists all tables in the specified dataset. Requires the READER dataset
    /// role.
    ///
    /// # IAM Permissions
    ///
    /// Requires the `bigquery.tables.list` permission on the dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_bigquery_v2::client::TableService;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_bigquery_v2::Result;
    /// async fn sample(
    ///    client: &TableService
    /// ) -> Result<()> {
    ///     let mut list = client.list_tables()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_tables(&self) -> super::builder::table_service::ListTables {
        super::builder::table_service::ListTables::new(self.inner.clone())
    }
}