google_cloud_dialogflow_v2/

client.rs

// 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 Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Agents;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = Agents::builder().build().await?;
///     let mut list = client.search_agents()
///         /* set fields */
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing [Agents][google.cloud.dialogflow.v2.Agent].
///
/// [google.cloud.dialogflow.v2.Agent]: crate::model::Agent
///
/// # Configuration
///
/// To configure `Agents` use the `with_*` methods in the type returned
/// by [builder()][Agents::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://dialogflow.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::agents::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::agents::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
///
/// `Agents` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Agents` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "agents")]
#[cfg_attr(docsrs, doc(cfg(feature = "agents")))]
#[derive(Clone, Debug)]
pub struct Agents {
    inner: std::sync::Arc<dyn super::stub::dynamic::Agents>,
}

#[cfg(feature = "agents")]
impl Agents {
    /// Returns a builder for [Agents].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// let client = Agents::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::agents::ClientBuilder {
        crate::new_client_builder(super::builder::agents::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::Agents + '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::Agents>> {
        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::Agents> {
        super::transport::Agents::new(conf).await
    }

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

    /// Retrieves the specified agent.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     let response = client.get_agent()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_agent(&self) -> super::builder::agents::GetAgent {
        super::builder::agents::GetAgent::new(self.inner.clone())
    }

    /// Creates/updates the specified agent.
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     let response = client.set_agent()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn set_agent(&self) -> super::builder::agents::SetAgent {
        super::builder::agents::SetAgent::new(self.inner.clone())
    }

    /// Deletes the specified agent.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     client.delete_agent()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_agent(&self) -> super::builder::agents::DeleteAgent {
        super::builder::agents::DeleteAgent::new(self.inner.clone())
    }

    /// Returns the list of agents.
    ///
    /// Since there is at most one conversational agent per project, this method is
    /// useful primarily for listing all agents across projects the caller has
    /// access to. One can achieve that with a wildcard project collection id "-".
    /// Refer to [List
    /// Sub-Collections](https://cloud.google.com/apis/design/design_patterns#list_sub-collections).
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     let mut list = client.search_agents()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn search_agents(&self) -> super::builder::agents::SearchAgents {
        super::builder::agents::SearchAgents::new(self.inner.clone())
    }

    /// Trains the specified agent.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     client.train_agent()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn train_agent(&self) -> super::builder::agents::TrainAgent {
        super::builder::agents::TrainAgent::new(self.inner.clone())
    }

    /// Exports the specified agent to a ZIP file.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`:
    ///   [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]
    ///
    /// [google.cloud.dialogflow.v2.ExportAgentResponse]: crate::model::ExportAgentResponse
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     let response = client.export_agent()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn export_agent(&self) -> super::builder::agents::ExportAgent {
        super::builder::agents::ExportAgent::new(self.inner.clone())
    }

    /// Imports the specified agent from a ZIP file.
    ///
    /// Uploads new intents and entity types without deleting the existing ones.
    /// Intents and entity types with the same name are replaced with the new
    /// versions from
    /// [ImportAgentRequest][google.cloud.dialogflow.v2.ImportAgentRequest]. After
    /// the import, the imported draft agent will be trained automatically (unless
    /// disabled in agent settings). However, once the import is done, training may
    /// not be completed yet. Please call
    /// [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the
    /// operation it returns in order to train explicitly.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// The operation only tracks when importing is complete, not when it is done
    /// training.
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// [google.cloud.dialogflow.v2.Agents.TrainAgent]: crate::client::Agents::train_agent
    /// [google.cloud.dialogflow.v2.ImportAgentRequest]: crate::model::ImportAgentRequest
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     client.import_agent()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn import_agent(&self) -> super::builder::agents::ImportAgent {
        super::builder::agents::ImportAgent::new(self.inner.clone())
    }

    /// Restores the specified agent from a ZIP file.
    ///
    /// Replaces the current agent version with a new one. All the intents and
    /// entity types in the older version are deleted. After the restore, the
    /// restored draft agent will be trained automatically (unless disabled in
    /// agent settings). However, once the restore is done, training may not be
    /// completed yet. Please call
    /// [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the
    /// operation it returns in order to train explicitly.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// The operation only tracks when restoring is complete, not when it is done
    /// training.
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// [google.cloud.dialogflow.v2.Agents.TrainAgent]: crate::client::Agents::train_agent
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     client.restore_agent()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn restore_agent(&self) -> super::builder::agents::RestoreAgent {
        super::builder::agents::RestoreAgent::new(self.inner.clone())
    }

    /// Gets agent validation result. Agent validation is performed during
    /// training time and is updated automatically when training is completed.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     let response = client.get_validation_result()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_validation_result(&self) -> super::builder::agents::GetValidationResult {
        super::builder::agents::GetValidationResult::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::agents::ListLocations {
        super::builder::agents::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::agents::GetLocation {
        super::builder::agents::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::agents::ListOperations {
        super::builder::agents::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::agents::GetOperation {
        super::builder::agents::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Agents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Agents
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::agents::CancelOperation {
        super::builder::agents::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::AnswerRecords;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = AnswerRecords::builder().build().await?;
///     let mut list = client.list_answer_records()
///         .set_parent(format!("projects/{project_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing
/// [AnswerRecords][google.cloud.dialogflow.v2.AnswerRecord].
///
/// [google.cloud.dialogflow.v2.AnswerRecord]: crate::model::AnswerRecord
///
/// # Configuration
///
/// To configure `AnswerRecords` use the `with_*` methods in the type returned
/// by [builder()][AnswerRecords::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://dialogflow.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::answer_records::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::answer_records::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
///
/// `AnswerRecords` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `AnswerRecords` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "answer-records")]
#[cfg_attr(docsrs, doc(cfg(feature = "answer-records")))]
#[derive(Clone, Debug)]
pub struct AnswerRecords {
    inner: std::sync::Arc<dyn super::stub::dynamic::AnswerRecords>,
}

#[cfg(feature = "answer-records")]
impl AnswerRecords {
    /// Returns a builder for [AnswerRecords].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::AnswerRecords;
    /// let client = AnswerRecords::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::answer_records::ClientBuilder {
        crate::new_client_builder(super::builder::answer_records::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::AnswerRecords + '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::AnswerRecords>> {
        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::AnswerRecords> {
        super::transport::AnswerRecords::new(conf).await
    }

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

    /// Returns the list of all answer records in the specified project in reverse
    /// chronological order.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::AnswerRecords;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &AnswerRecords, project_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_answer_records()
    ///         .set_parent(format!("projects/{project_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_answer_records(&self) -> super::builder::answer_records::ListAnswerRecords {
        super::builder::answer_records::ListAnswerRecords::new(self.inner.clone())
    }

    /// Updates the specified answer record.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::AnswerRecords;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::AnswerRecord;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &AnswerRecords, project_id: &str, answer_record_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_answer_record()
    ///         .set_answer_record(
    ///             AnswerRecord::new().set_name(format!("projects/{project_id}/answerRecords/{answer_record_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_answer_record(&self) -> super::builder::answer_records::UpdateAnswerRecord {
        super::builder::answer_records::UpdateAnswerRecord::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::AnswerRecords;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &AnswerRecords
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::answer_records::ListLocations {
        super::builder::answer_records::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::AnswerRecords;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &AnswerRecords
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::answer_records::GetLocation {
        super::builder::answer_records::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::AnswerRecords;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &AnswerRecords
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::answer_records::ListOperations {
        super::builder::answer_records::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::AnswerRecords;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &AnswerRecords
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::answer_records::GetOperation {
        super::builder::answer_records::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::AnswerRecords;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &AnswerRecords
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::answer_records::CancelOperation {
        super::builder::answer_records::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Contexts;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
///    session_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = Contexts::builder().build().await?;
///     let mut list = client.list_contexts()
///         .set_parent(format!("projects/{project_id}/agent/sessions/{session_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing [Contexts][google.cloud.dialogflow.v2.Context].
///
/// [google.cloud.dialogflow.v2.Context]: crate::model::Context
///
/// # Configuration
///
/// To configure `Contexts` use the `with_*` methods in the type returned
/// by [builder()][Contexts::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://dialogflow.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::contexts::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::contexts::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
///
/// `Contexts` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Contexts` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "contexts")]
#[cfg_attr(docsrs, doc(cfg(feature = "contexts")))]
#[derive(Clone, Debug)]
pub struct Contexts {
    inner: std::sync::Arc<dyn super::stub::dynamic::Contexts>,
}

#[cfg(feature = "contexts")]
impl Contexts {
    /// Returns a builder for [Contexts].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// let client = Contexts::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::contexts::ClientBuilder {
        crate::new_client_builder(super::builder::contexts::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::Contexts + '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::Contexts>> {
        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::Contexts> {
        super::transport::Contexts::new(conf).await
    }

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

    /// Returns the list of all contexts in the specified session.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts, project_id: &str, session_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_contexts()
    ///         .set_parent(format!("projects/{project_id}/agent/sessions/{session_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_contexts(&self) -> super::builder::contexts::ListContexts {
        super::builder::contexts::ListContexts::new(self.inner.clone())
    }

    /// Retrieves the specified context.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts, project_id: &str, session_id: &str, context_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_context()
    ///         .set_name(format!("projects/{project_id}/agent/sessions/{session_id}/contexts/{context_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_context(&self) -> super::builder::contexts::GetContext {
        super::builder::contexts::GetContext::new(self.inner.clone())
    }

    /// Creates a context.
    ///
    /// If the specified context already exists, overrides the context.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_dialogflow_v2::model::Context;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts, project_id: &str, session_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_context()
    ///         .set_parent(format!("projects/{project_id}/agent/sessions/{session_id}"))
    ///         .set_context(
    ///             Context::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_context(&self) -> super::builder::contexts::CreateContext {
        super::builder::contexts::CreateContext::new(self.inner.clone())
    }

    /// Updates the specified context.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::Context;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts, project_id: &str, session_id: &str, context_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_context()
    ///         .set_context(
    ///             Context::new().set_name(format!("projects/{project_id}/agent/sessions/{session_id}/contexts/{context_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_context(&self) -> super::builder::contexts::UpdateContext {
        super::builder::contexts::UpdateContext::new(self.inner.clone())
    }

    /// Deletes the specified context.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts, project_id: &str, session_id: &str, context_id: &str
    /// ) -> Result<()> {
    ///     client.delete_context()
    ///         .set_name(format!("projects/{project_id}/agent/sessions/{session_id}/contexts/{context_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_context(&self) -> super::builder::contexts::DeleteContext {
        super::builder::contexts::DeleteContext::new(self.inner.clone())
    }

    /// Deletes all active contexts in the specified session.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts
    /// ) -> Result<()> {
    ///     client.delete_all_contexts()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_all_contexts(&self) -> super::builder::contexts::DeleteAllContexts {
        super::builder::contexts::DeleteAllContexts::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::contexts::ListLocations {
        super::builder::contexts::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::contexts::GetLocation {
        super::builder::contexts::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::contexts::ListOperations {
        super::builder::contexts::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::contexts::GetOperation {
        super::builder::contexts::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Contexts;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Contexts
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::contexts::CancelOperation {
        super::builder::contexts::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Conversations;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = Conversations::builder().build().await?;
///     let mut list = client.list_conversations()
///         .set_parent(format!("projects/{project_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing
/// [Conversations][google.cloud.dialogflow.v2.Conversation].
///
/// [google.cloud.dialogflow.v2.Conversation]: crate::model::Conversation
///
/// # Configuration
///
/// To configure `Conversations` use the `with_*` methods in the type returned
/// by [builder()][Conversations::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://dialogflow.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::conversations::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::conversations::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
///
/// `Conversations` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Conversations` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "conversations")]
#[cfg_attr(docsrs, doc(cfg(feature = "conversations")))]
#[derive(Clone, Debug)]
pub struct Conversations {
    inner: std::sync::Arc<dyn super::stub::dynamic::Conversations>,
}

#[cfg(feature = "conversations")]
impl Conversations {
    /// Returns a builder for [Conversations].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// let client = Conversations::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::conversations::ClientBuilder {
        crate::new_client_builder(super::builder::conversations::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::Conversations + '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::Conversations>> {
        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::Conversations> {
        super::transport::Conversations::new(conf).await
    }

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

    /// Creates a new conversation. Conversations are auto-completed after 24
    /// hours.
    ///
    /// Conversation Lifecycle:
    /// There are two stages during a conversation: Automated Agent Stage and
    /// Assist Stage.
    ///
    /// For Automated Agent Stage, there will be a dialogflow agent responding to
    /// user queries.
    ///
    /// For Assist Stage, there's no dialogflow agent responding to user queries.
    /// But we will provide suggestions which are generated from conversation.
    ///
    /// If
    /// [Conversation.conversation_profile][google.cloud.dialogflow.v2.Conversation.conversation_profile]
    /// is configured for a dialogflow agent, conversation will start from
    /// `Automated Agent Stage`, otherwise, it will start from `Assist Stage`. And
    /// during `Automated Agent Stage`, once an
    /// [Intent][google.cloud.dialogflow.v2.Intent] with
    /// [Intent.live_agent_handoff][google.cloud.dialogflow.v2.Intent.live_agent_handoff]
    /// is triggered, conversation will transfer to Assist Stage.
    ///
    /// [google.cloud.dialogflow.v2.Conversation.conversation_profile]: crate::model::Conversation::conversation_profile
    /// [google.cloud.dialogflow.v2.Intent]: crate::model::Intent
    /// [google.cloud.dialogflow.v2.Intent.live_agent_handoff]: crate::model::Intent::live_agent_handoff
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::model::Conversation;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations, project_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_conversation()
    ///         .set_parent(format!("projects/{project_id}"))
    ///         .set_conversation_id("conversation_id_value")
    ///         .set_conversation(
    ///             Conversation::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_conversation(&self) -> super::builder::conversations::CreateConversation {
        super::builder::conversations::CreateConversation::new(self.inner.clone())
    }

    /// Returns the list of all conversations in the specified project.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations, project_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_conversations()
    ///         .set_parent(format!("projects/{project_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_conversations(&self) -> super::builder::conversations::ListConversations {
        super::builder::conversations::ListConversations::new(self.inner.clone())
    }

    /// Retrieves the specific conversation.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations, project_id: &str, conversation_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_conversation()
    ///         .set_name(format!("projects/{project_id}/conversations/{conversation_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_conversation(&self) -> super::builder::conversations::GetConversation {
        super::builder::conversations::GetConversation::new(self.inner.clone())
    }

    /// Completes the specified conversation. Finished conversations are purged
    /// from the database after 30 days.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let response = client.complete_conversation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn complete_conversation(&self) -> super::builder::conversations::CompleteConversation {
        super::builder::conversations::CompleteConversation::new(self.inner.clone())
    }

    /// Data ingestion API.
    /// Ingests context references for an existing conversation.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let response = client.ingest_context_references()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn ingest_context_references(
        &self,
    ) -> super::builder::conversations::IngestContextReferences {
        super::builder::conversations::IngestContextReferences::new(self.inner.clone())
    }

    /// Lists messages that belong to a given conversation.
    /// `messages` are ordered by `create_time` in descending order. To fetch
    /// updates without duplication, send request with filter
    /// `create_time_epoch_microseconds >
    /// [first item's create_time of previous request]` and empty page_token.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations, project_id: &str, conversation_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_messages()
    ///         .set_parent(format!("projects/{project_id}/conversations/{conversation_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_messages(&self) -> super::builder::conversations::ListMessages {
        super::builder::conversations::ListMessages::new(self.inner.clone())
    }

    /// Suggests summary for a conversation based on specific historical messages.
    /// The range of the messages to be used for summary can be specified in the
    /// request.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let response = client.suggest_conversation_summary()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn suggest_conversation_summary(
        &self,
    ) -> super::builder::conversations::SuggestConversationSummary {
        super::builder::conversations::SuggestConversationSummary::new(self.inner.clone())
    }

    /// Generates and returns a summary for a conversation that does not have a
    /// resource created for it.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let response = client.generate_stateless_summary()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn generate_stateless_summary(
        &self,
    ) -> super::builder::conversations::GenerateStatelessSummary {
        super::builder::conversations::GenerateStatelessSummary::new(self.inner.clone())
    }

    /// Generates and returns a suggestion for a conversation that does not have a
    /// resource created for it.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let response = client.generate_stateless_suggestion()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn generate_stateless_suggestion(
        &self,
    ) -> super::builder::conversations::GenerateStatelessSuggestion {
        super::builder::conversations::GenerateStatelessSuggestion::new(self.inner.clone())
    }

    /// Get answers for the given query based on knowledge documents.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let response = client.search_knowledge()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn search_knowledge(&self) -> super::builder::conversations::SearchKnowledge {
        super::builder::conversations::SearchKnowledge::new(self.inner.clone())
    }

    /// Generates all the suggestions using generators configured in the
    /// conversation profile. A generator is used only if its trigger event is
    /// matched.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let response = client.generate_suggestions()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn generate_suggestions(&self) -> super::builder::conversations::GenerateSuggestions {
        super::builder::conversations::GenerateSuggestions::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::conversations::ListLocations {
        super::builder::conversations::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::conversations::GetLocation {
        super::builder::conversations::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::conversations::ListOperations {
        super::builder::conversations::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::conversations::GetOperation {
        super::builder::conversations::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Conversations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Conversations
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::conversations::CancelOperation {
        super::builder::conversations::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
///    location_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = ConversationDatasets::builder().build().await?;
///     let mut list = client.list_conversation_datasets()
///         .set_parent(format!("projects/{project_id}/locations/{location_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Conversation datasets.
///
/// Conversation datasets contain raw conversation files and their
/// customizable metadata that can be used for model training.
///
/// # Configuration
///
/// To configure `ConversationDatasets` use the `with_*` methods in the type returned
/// by [builder()][ConversationDatasets::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://dialogflow.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::conversation_datasets::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::conversation_datasets::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
///
/// `ConversationDatasets` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `ConversationDatasets` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "conversation-datasets")]
#[cfg_attr(docsrs, doc(cfg(feature = "conversation-datasets")))]
#[derive(Clone, Debug)]
pub struct ConversationDatasets {
    inner: std::sync::Arc<dyn super::stub::dynamic::ConversationDatasets>,
}

#[cfg(feature = "conversation-datasets")]
impl ConversationDatasets {
    /// Returns a builder for [ConversationDatasets].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// let client = ConversationDatasets::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::conversation_datasets::ClientBuilder {
        crate::new_client_builder(super::builder::conversation_datasets::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::ConversationDatasets + '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::ConversationDatasets>>
    {
        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::ConversationDatasets> {
        super::transport::ConversationDatasets::new(conf).await
    }

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

    /// Creates a new conversation dataset.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [CreateConversationDatasetOperationMetadata][google.cloud.dialogflow.v2.CreateConversationDatasetOperationMetadata]
    /// - `response`:
    ///   [ConversationDataset][google.cloud.dialogflow.v2.ConversationDataset]
    ///
    /// [google.cloud.dialogflow.v2.ConversationDataset]: crate::model::ConversationDataset
    /// [google.cloud.dialogflow.v2.CreateConversationDatasetOperationMetadata]: crate::model::CreateConversationDatasetOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::model::ConversationDataset;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets, parent: &str
    /// ) -> Result<()> {
    ///     let response = client.create_conversation_dataset()
    ///         .set_parent(parent)
    ///         .set_conversation_dataset(
    ///             ConversationDataset::new()/* set fields */
    ///         )
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_conversation_dataset(
        &self,
    ) -> super::builder::conversation_datasets::CreateConversationDataset {
        super::builder::conversation_datasets::CreateConversationDataset::new(self.inner.clone())
    }

    /// Retrieves the specified conversation dataset.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets, project_id: &str, location_id: &str, conversation_dataset_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_conversation_dataset()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/conversationDatasets/{conversation_dataset_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_conversation_dataset(
        &self,
    ) -> super::builder::conversation_datasets::GetConversationDataset {
        super::builder::conversation_datasets::GetConversationDataset::new(self.inner.clone())
    }

    /// Returns the list of all conversation datasets in the specified
    /// project and location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets, project_id: &str, location_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_conversation_datasets()
    ///         .set_parent(format!("projects/{project_id}/locations/{location_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_conversation_datasets(
        &self,
    ) -> super::builder::conversation_datasets::ListConversationDatasets {
        super::builder::conversation_datasets::ListConversationDatasets::new(self.inner.clone())
    }

    /// Deletes the specified conversation dataset.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [DeleteConversationDatasetOperationMetadata][google.cloud.dialogflow.v2.DeleteConversationDatasetOperationMetadata]
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// [google.cloud.dialogflow.v2.DeleteConversationDatasetOperationMetadata]: crate::model::DeleteConversationDatasetOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets, project_id: &str, location_id: &str, conversation_dataset_id: &str
    /// ) -> Result<()> {
    ///     client.delete_conversation_dataset()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/conversationDatasets/{conversation_dataset_id}"))
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_conversation_dataset(
        &self,
    ) -> super::builder::conversation_datasets::DeleteConversationDataset {
        super::builder::conversation_datasets::DeleteConversationDataset::new(self.inner.clone())
    }

    /// Import data into the specified conversation dataset. Note that it
    /// is not allowed to import data to a conversation dataset that
    /// already has data in it.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [ImportConversationDataOperationMetadata][google.cloud.dialogflow.v2.ImportConversationDataOperationMetadata]
    /// - `response`:
    ///   [ImportConversationDataOperationResponse][google.cloud.dialogflow.v2.ImportConversationDataOperationResponse]
    ///
    /// [google.cloud.dialogflow.v2.ImportConversationDataOperationMetadata]: crate::model::ImportConversationDataOperationMetadata
    /// [google.cloud.dialogflow.v2.ImportConversationDataOperationResponse]: crate::model::ImportConversationDataOperationResponse
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets
    /// ) -> Result<()> {
    ///     let response = client.import_conversation_data()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn import_conversation_data(
        &self,
    ) -> super::builder::conversation_datasets::ImportConversationData {
        super::builder::conversation_datasets::ImportConversationData::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::conversation_datasets::ListLocations {
        super::builder::conversation_datasets::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::conversation_datasets::GetLocation {
        super::builder::conversation_datasets::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::conversation_datasets::ListOperations {
        super::builder::conversation_datasets::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::conversation_datasets::GetOperation {
        super::builder::conversation_datasets::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationDatasets;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationDatasets
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::conversation_datasets::CancelOperation {
        super::builder::conversation_datasets::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::ConversationModels;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    parent: &str,
/// ) -> anyhow::Result<()> {
///     let client = ConversationModels::builder().build().await?;
///     let mut list = client.list_conversation_models()
///         .set_parent(parent)
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Manages a collection of models for human agent assistant.
///
/// # Configuration
///
/// To configure `ConversationModels` use the `with_*` methods in the type returned
/// by [builder()][ConversationModels::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://dialogflow.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::conversation_models::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::conversation_models::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
///
/// `ConversationModels` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `ConversationModels` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "conversation-models")]
#[cfg_attr(docsrs, doc(cfg(feature = "conversation-models")))]
#[derive(Clone, Debug)]
pub struct ConversationModels {
    inner: std::sync::Arc<dyn super::stub::dynamic::ConversationModels>,
}

#[cfg(feature = "conversation-models")]
impl ConversationModels {
    /// Returns a builder for [ConversationModels].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// let client = ConversationModels::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::conversation_models::ClientBuilder {
        crate::new_client_builder(super::builder::conversation_models::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::ConversationModels + '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::ConversationModels>>
    {
        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::ConversationModels> {
        super::transport::ConversationModels::new(conf).await
    }

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

    /// Creates a model.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [CreateConversationModelOperationMetadata][google.cloud.dialogflow.v2.CreateConversationModelOperationMetadata]
    /// - `response`:
    ///   [ConversationModel][google.cloud.dialogflow.v2.ConversationModel]
    ///
    /// [google.cloud.dialogflow.v2.ConversationModel]: crate::model::ConversationModel
    /// [google.cloud.dialogflow.v2.CreateConversationModelOperationMetadata]: crate::model::CreateConversationModelOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::model::ConversationModel;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels, parent: &str
    /// ) -> Result<()> {
    ///     let response = client.create_conversation_model()
    ///         .set_parent(parent)
    ///         .set_conversation_model(
    ///             ConversationModel::new()/* set fields */
    ///         )
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_conversation_model(
        &self,
    ) -> super::builder::conversation_models::CreateConversationModel {
        super::builder::conversation_models::CreateConversationModel::new(self.inner.clone())
    }

    /// Gets conversation model.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     let response = client.get_conversation_model()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_conversation_model(
        &self,
    ) -> super::builder::conversation_models::GetConversationModel {
        super::builder::conversation_models::GetConversationModel::new(self.inner.clone())
    }

    /// Lists conversation models.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels, parent: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_conversation_models()
    ///         .set_parent(parent)
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_conversation_models(
        &self,
    ) -> super::builder::conversation_models::ListConversationModels {
        super::builder::conversation_models::ListConversationModels::new(self.inner.clone())
    }

    /// Deletes a model.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [DeleteConversationModelOperationMetadata][google.cloud.dialogflow.v2.DeleteConversationModelOperationMetadata]
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// [google.cloud.dialogflow.v2.DeleteConversationModelOperationMetadata]: crate::model::DeleteConversationModelOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     client.delete_conversation_model()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_conversation_model(
        &self,
    ) -> super::builder::conversation_models::DeleteConversationModel {
        super::builder::conversation_models::DeleteConversationModel::new(self.inner.clone())
    }

    /// Deploys a model. If a model is already deployed, deploying it
    /// has no effect. A model can only serve prediction requests after it gets
    /// deployed. For article suggestion, custom model will not be used unless
    /// it is deployed.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [DeployConversationModelOperationMetadata][google.cloud.dialogflow.v2.DeployConversationModelOperationMetadata]
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// [google.cloud.dialogflow.v2.DeployConversationModelOperationMetadata]: crate::model::DeployConversationModelOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     client.deploy_conversation_model()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn deploy_conversation_model(
        &self,
    ) -> super::builder::conversation_models::DeployConversationModel {
        super::builder::conversation_models::DeployConversationModel::new(self.inner.clone())
    }

    /// Undeploys a model. If the model is not deployed this method has no effect.
    /// If the model is currently being used:
    ///
    /// - For article suggestion, article suggestion will fallback to the default
    ///   model if model is undeployed.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [UndeployConversationModelOperationMetadata][google.cloud.dialogflow.v2.UndeployConversationModelOperationMetadata]
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// [google.cloud.dialogflow.v2.UndeployConversationModelOperationMetadata]: crate::model::UndeployConversationModelOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     client.undeploy_conversation_model()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn undeploy_conversation_model(
        &self,
    ) -> super::builder::conversation_models::UndeployConversationModel {
        super::builder::conversation_models::UndeployConversationModel::new(self.inner.clone())
    }

    /// Gets an evaluation of conversation model.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     let response = client.get_conversation_model_evaluation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_conversation_model_evaluation(
        &self,
    ) -> super::builder::conversation_models::GetConversationModelEvaluation {
        super::builder::conversation_models::GetConversationModelEvaluation::new(self.inner.clone())
    }

    /// Lists evaluations of a conversation model.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels, parent: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_conversation_model_evaluations()
    ///         .set_parent(parent)
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_conversation_model_evaluations(
        &self,
    ) -> super::builder::conversation_models::ListConversationModelEvaluations {
        super::builder::conversation_models::ListConversationModelEvaluations::new(
            self.inner.clone(),
        )
    }

    /// Creates evaluation of a conversation model.
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     let response = client.create_conversation_model_evaluation()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_conversation_model_evaluation(
        &self,
    ) -> super::builder::conversation_models::CreateConversationModelEvaluation {
        super::builder::conversation_models::CreateConversationModelEvaluation::new(
            self.inner.clone(),
        )
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::conversation_models::ListLocations {
        super::builder::conversation_models::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::conversation_models::GetLocation {
        super::builder::conversation_models::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::conversation_models::ListOperations {
        super::builder::conversation_models::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::conversation_models::GetOperation {
        super::builder::conversation_models::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationModels;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationModels
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::conversation_models::CancelOperation {
        super::builder::conversation_models::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = ConversationProfiles::builder().build().await?;
///     let mut list = client.list_conversation_profiles()
///         .set_parent(format!("projects/{project_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing
/// [ConversationProfiles][google.cloud.dialogflow.v2.ConversationProfile].
///
/// [google.cloud.dialogflow.v2.ConversationProfile]: crate::model::ConversationProfile
///
/// # Configuration
///
/// To configure `ConversationProfiles` use the `with_*` methods in the type returned
/// by [builder()][ConversationProfiles::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://dialogflow.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::conversation_profiles::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::conversation_profiles::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
///
/// `ConversationProfiles` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `ConversationProfiles` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "conversation-profiles")]
#[cfg_attr(docsrs, doc(cfg(feature = "conversation-profiles")))]
#[derive(Clone, Debug)]
pub struct ConversationProfiles {
    inner: std::sync::Arc<dyn super::stub::dynamic::ConversationProfiles>,
}

#[cfg(feature = "conversation-profiles")]
impl ConversationProfiles {
    /// Returns a builder for [ConversationProfiles].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// let client = ConversationProfiles::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::conversation_profiles::ClientBuilder {
        crate::new_client_builder(super::builder::conversation_profiles::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::ConversationProfiles + '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::ConversationProfiles>>
    {
        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::ConversationProfiles> {
        super::transport::ConversationProfiles::new(conf).await
    }

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

    /// Returns the list of all conversation profiles in the specified project.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles, project_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_conversation_profiles()
    ///         .set_parent(format!("projects/{project_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_conversation_profiles(
        &self,
    ) -> super::builder::conversation_profiles::ListConversationProfiles {
        super::builder::conversation_profiles::ListConversationProfiles::new(self.inner.clone())
    }

    /// Retrieves the specified conversation profile.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles, project_id: &str, conversation_profile_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_conversation_profile()
    ///         .set_name(format!("projects/{project_id}/conversationProfiles/{conversation_profile_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_conversation_profile(
        &self,
    ) -> super::builder::conversation_profiles::GetConversationProfile {
        super::builder::conversation_profiles::GetConversationProfile::new(self.inner.clone())
    }

    /// Creates a conversation profile in the specified project.
    ///
    /// [ConversationProfile.create_time][google.cloud.dialogflow.v2.ConversationProfile.create_time]
    /// and
    /// [ConversationProfile.update_time][google.cloud.dialogflow.v2.ConversationProfile.update_time]
    /// aren't populated in the response. You can retrieve them via
    /// [GetConversationProfile][google.cloud.dialogflow.v2.ConversationProfiles.GetConversationProfile]
    /// API.
    ///
    /// [google.cloud.dialogflow.v2.ConversationProfile.create_time]: crate::model::ConversationProfile::create_time
    /// [google.cloud.dialogflow.v2.ConversationProfile.update_time]: crate::model::ConversationProfile::update_time
    /// [google.cloud.dialogflow.v2.ConversationProfiles.GetConversationProfile]: crate::client::ConversationProfiles::get_conversation_profile
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_dialogflow_v2::model::ConversationProfile;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles, project_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_conversation_profile()
    ///         .set_parent(format!("projects/{project_id}"))
    ///         .set_conversation_profile(
    ///             ConversationProfile::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_conversation_profile(
        &self,
    ) -> super::builder::conversation_profiles::CreateConversationProfile {
        super::builder::conversation_profiles::CreateConversationProfile::new(self.inner.clone())
    }

    /// Updates the specified conversation profile.
    ///
    /// [ConversationProfile.create_time][google.cloud.dialogflow.v2.ConversationProfile.create_time]
    /// and
    /// [ConversationProfile.update_time][google.cloud.dialogflow.v2.ConversationProfile.update_time]
    /// aren't populated in the response. You can retrieve them via
    /// [GetConversationProfile][google.cloud.dialogflow.v2.ConversationProfiles.GetConversationProfile]
    /// API.
    ///
    /// [google.cloud.dialogflow.v2.ConversationProfile.create_time]: crate::model::ConversationProfile::create_time
    /// [google.cloud.dialogflow.v2.ConversationProfile.update_time]: crate::model::ConversationProfile::update_time
    /// [google.cloud.dialogflow.v2.ConversationProfiles.GetConversationProfile]: crate::client::ConversationProfiles::get_conversation_profile
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::ConversationProfile;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles, project_id: &str, conversation_profile_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_conversation_profile()
    ///         .set_conversation_profile(
    ///             ConversationProfile::new().set_name(format!("projects/{project_id}/conversationProfiles/{conversation_profile_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_conversation_profile(
        &self,
    ) -> super::builder::conversation_profiles::UpdateConversationProfile {
        super::builder::conversation_profiles::UpdateConversationProfile::new(self.inner.clone())
    }

    /// Deletes the specified conversation profile.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles, project_id: &str, conversation_profile_id: &str
    /// ) -> Result<()> {
    ///     client.delete_conversation_profile()
    ///         .set_name(format!("projects/{project_id}/conversationProfiles/{conversation_profile_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_conversation_profile(
        &self,
    ) -> super::builder::conversation_profiles::DeleteConversationProfile {
        super::builder::conversation_profiles::DeleteConversationProfile::new(self.inner.clone())
    }

    /// Adds or updates a suggestion feature in a conversation profile.
    /// If the conversation profile contains the type of suggestion feature for
    /// the participant role, it will update it. Otherwise it will insert the
    /// suggestion feature.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [SetSuggestionFeatureConfigOperationMetadata][google.cloud.dialogflow.v2.SetSuggestionFeatureConfigOperationMetadata]
    /// - `response`:
    ///   [ConversationProfile][google.cloud.dialogflow.v2.ConversationProfile]
    ///
    /// If a long running operation to add or update suggestion feature
    /// config for the same conversation profile, participant role and suggestion
    /// feature type exists, please cancel the existing long running operation
    /// before sending such request, otherwise the request will be rejected.
    ///
    /// [google.cloud.dialogflow.v2.ConversationProfile]: crate::model::ConversationProfile
    /// [google.cloud.dialogflow.v2.SetSuggestionFeatureConfigOperationMetadata]: crate::model::SetSuggestionFeatureConfigOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles
    /// ) -> Result<()> {
    ///     let response = client.set_suggestion_feature_config()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn set_suggestion_feature_config(
        &self,
    ) -> super::builder::conversation_profiles::SetSuggestionFeatureConfig {
        super::builder::conversation_profiles::SetSuggestionFeatureConfig::new(self.inner.clone())
    }

    /// Clears a suggestion feature from a conversation profile for the given
    /// participant role.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [ClearSuggestionFeatureConfigOperationMetadata][google.cloud.dialogflow.v2.ClearSuggestionFeatureConfigOperationMetadata]
    /// - `response`:
    ///   [ConversationProfile][google.cloud.dialogflow.v2.ConversationProfile]
    ///
    /// [google.cloud.dialogflow.v2.ClearSuggestionFeatureConfigOperationMetadata]: crate::model::ClearSuggestionFeatureConfigOperationMetadata
    /// [google.cloud.dialogflow.v2.ConversationProfile]: crate::model::ConversationProfile
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles
    /// ) -> Result<()> {
    ///     let response = client.clear_suggestion_feature_config()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn clear_suggestion_feature_config(
        &self,
    ) -> super::builder::conversation_profiles::ClearSuggestionFeatureConfig {
        super::builder::conversation_profiles::ClearSuggestionFeatureConfig::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::conversation_profiles::ListLocations {
        super::builder::conversation_profiles::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::conversation_profiles::GetLocation {
        super::builder::conversation_profiles::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::conversation_profiles::ListOperations {
        super::builder::conversation_profiles::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::conversation_profiles::GetOperation {
        super::builder::conversation_profiles::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::ConversationProfiles;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &ConversationProfiles
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::conversation_profiles::CancelOperation {
        super::builder::conversation_profiles::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Documents;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
///    knowledge_base_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = Documents::builder().build().await?;
///     let mut list = client.list_documents()
///         .set_parent(format!("projects/{project_id}/knowledgeBases/{knowledge_base_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing knowledge
/// [Documents][google.cloud.dialogflow.v2.Document].
///
/// [google.cloud.dialogflow.v2.Document]: crate::model::Document
///
/// # Configuration
///
/// To configure `Documents` use the `with_*` methods in the type returned
/// by [builder()][Documents::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://dialogflow.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::documents::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::documents::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
///
/// `Documents` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Documents` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "documents")]
#[cfg_attr(docsrs, doc(cfg(feature = "documents")))]
#[derive(Clone, Debug)]
pub struct Documents {
    inner: std::sync::Arc<dyn super::stub::dynamic::Documents>,
}

#[cfg(feature = "documents")]
impl Documents {
    /// Returns a builder for [Documents].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// let client = Documents::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::documents::ClientBuilder {
        crate::new_client_builder(super::builder::documents::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::Documents + '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::Documents>> {
        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::Documents> {
        super::transport::Documents::new(conf).await
    }

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

    /// Returns the list of all documents of the knowledge base.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents, project_id: &str, knowledge_base_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_documents()
    ///         .set_parent(format!("projects/{project_id}/knowledgeBases/{knowledge_base_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_documents(&self) -> super::builder::documents::ListDocuments {
        super::builder::documents::ListDocuments::new(self.inner.clone())
    }

    /// Retrieves the specified document.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents, project_id: &str, knowledge_base_id: &str, document_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_document()
    ///         .set_name(format!("projects/{project_id}/knowledgeBases/{knowledge_base_id}/documents/{document_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_document(&self) -> super::builder::documents::GetDocument {
        super::builder::documents::GetDocument::new(self.inner.clone())
    }

    /// Creates a new document.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
    /// - `response`: [Document][google.cloud.dialogflow.v2.Document]
    ///
    /// [google.cloud.dialogflow.v2.Document]: crate::model::Document
    /// [google.cloud.dialogflow.v2.KnowledgeOperationMetadata]: crate::model::KnowledgeOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::model::Document;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents, project_id: &str, knowledge_base_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_document()
    ///         .set_parent(format!("projects/{project_id}/knowledgeBases/{knowledge_base_id}"))
    ///         .set_document(
    ///             Document::new()/* set fields */
    ///         )
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_document(&self) -> super::builder::documents::CreateDocument {
        super::builder::documents::CreateDocument::new(self.inner.clone())
    }

    /// Creates documents by importing data from external sources.
    /// Dialogflow supports up to 350 documents in each request. If you try to
    /// import more, Dialogflow will return an error.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
    /// - `response`:
    ///   [ImportDocumentsResponse][google.cloud.dialogflow.v2.ImportDocumentsResponse]
    ///
    /// [google.cloud.dialogflow.v2.ImportDocumentsResponse]: crate::model::ImportDocumentsResponse
    /// [google.cloud.dialogflow.v2.KnowledgeOperationMetadata]: crate::model::KnowledgeOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents
    /// ) -> Result<()> {
    ///     let response = client.import_documents()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn import_documents(&self) -> super::builder::documents::ImportDocuments {
        super::builder::documents::ImportDocuments::new(self.inner.clone())
    }

    /// Deletes the specified document.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// [google.cloud.dialogflow.v2.KnowledgeOperationMetadata]: crate::model::KnowledgeOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents, project_id: &str, knowledge_base_id: &str, document_id: &str
    /// ) -> Result<()> {
    ///     client.delete_document()
    ///         .set_name(format!("projects/{project_id}/knowledgeBases/{knowledge_base_id}/documents/{document_id}"))
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_document(&self) -> super::builder::documents::DeleteDocument {
        super::builder::documents::DeleteDocument::new(self.inner.clone())
    }

    /// Updates the specified document.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
    /// - `response`: [Document][google.cloud.dialogflow.v2.Document]
    ///
    /// [google.cloud.dialogflow.v2.Document]: crate::model::Document
    /// [google.cloud.dialogflow.v2.KnowledgeOperationMetadata]: crate::model::KnowledgeOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_lro::Poller;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::Document;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents, project_id: &str, knowledge_base_id: &str, document_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_document()
    ///         .set_document(
    ///             Document::new().set_name(format!("projects/{project_id}/knowledgeBases/{knowledge_base_id}/documents/{document_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_document(&self) -> super::builder::documents::UpdateDocument {
        super::builder::documents::UpdateDocument::new(self.inner.clone())
    }

    /// Reloads the specified document from its specified source, content_uri or
    /// content. The previously loaded content of the document will be deleted.
    /// Note: Even when the content of the document has not changed, there still
    /// may be side effects because of internal implementation changes.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
    /// - `response`: [Document][google.cloud.dialogflow.v2.Document]
    ///
    /// Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
    /// only use `projects.knowledgeBases.documents`.
    ///
    /// [google.cloud.dialogflow.v2.Document]: crate::model::Document
    /// [google.cloud.dialogflow.v2.KnowledgeOperationMetadata]: crate::model::KnowledgeOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents
    /// ) -> Result<()> {
    ///     let response = client.reload_document()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn reload_document(&self) -> super::builder::documents::ReloadDocument {
        super::builder::documents::ReloadDocument::new(self.inner.clone())
    }

    /// Exports a smart messaging candidate document into the specified
    /// destination.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`:
    ///   [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
    /// - `response`: [Document][google.cloud.dialogflow.v2.Document]
    ///
    /// [google.cloud.dialogflow.v2.Document]: crate::model::Document
    /// [google.cloud.dialogflow.v2.KnowledgeOperationMetadata]: crate::model::KnowledgeOperationMetadata
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents
    /// ) -> Result<()> {
    ///     let response = client.export_document()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn export_document(&self) -> super::builder::documents::ExportDocument {
        super::builder::documents::ExportDocument::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::documents::ListLocations {
        super::builder::documents::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::documents::GetLocation {
        super::builder::documents::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::documents::ListOperations {
        super::builder::documents::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::documents::GetOperation {
        super::builder::documents::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Documents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Documents
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::documents::CancelOperation {
        super::builder::documents::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::EncryptionSpecService;
/// async fn sample(
///    project_id: &str,
///    location_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = EncryptionSpecService::builder().build().await?;
///     let response = client.get_encryption_spec()
///         .set_name(format!("projects/{project_id}/locations/{location_id}/encryptionSpec"))
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Manages encryption spec settings for Dialogflow and Agent Assist.
///
/// # Configuration
///
/// To configure `EncryptionSpecService` use the `with_*` methods in the type returned
/// by [builder()][EncryptionSpecService::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://dialogflow.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::encryption_spec_service::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::encryption_spec_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
///
/// `EncryptionSpecService` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `EncryptionSpecService` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "encryption-spec-service")]
#[cfg_attr(docsrs, doc(cfg(feature = "encryption-spec-service")))]
#[derive(Clone, Debug)]
pub struct EncryptionSpecService {
    inner: std::sync::Arc<dyn super::stub::dynamic::EncryptionSpecService>,
}

#[cfg(feature = "encryption-spec-service")]
impl EncryptionSpecService {
    /// Returns a builder for [EncryptionSpecService].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::EncryptionSpecService;
    /// let client = EncryptionSpecService::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::encryption_spec_service::ClientBuilder {
        crate::new_client_builder(super::builder::encryption_spec_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::EncryptionSpecService + '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::EncryptionSpecService>>
    {
        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::EncryptionSpecService> {
        super::transport::EncryptionSpecService::new(conf).await
    }

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

    /// Gets location-level encryption key specification.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EncryptionSpecService;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EncryptionSpecService, project_id: &str, location_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_encryption_spec()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/encryptionSpec"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_encryption_spec(
        &self,
    ) -> super::builder::encryption_spec_service::GetEncryptionSpec {
        super::builder::encryption_spec_service::GetEncryptionSpec::new(self.inner.clone())
    }

    /// Initializes a location-level encryption key specification.  An error will
    /// be thrown if the location has resources already created before the
    /// initialization. Once the encryption specification is initialized at a
    /// location, it is immutable and all newly created resources under the
    /// location will be encrypted with the existing specification.
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EncryptionSpecService;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EncryptionSpecService
    /// ) -> Result<()> {
    ///     let response = client.initialize_encryption_spec()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn initialize_encryption_spec(
        &self,
    ) -> super::builder::encryption_spec_service::InitializeEncryptionSpec {
        super::builder::encryption_spec_service::InitializeEncryptionSpec::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EncryptionSpecService;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EncryptionSpecService
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::encryption_spec_service::ListLocations {
        super::builder::encryption_spec_service::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EncryptionSpecService;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EncryptionSpecService
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::encryption_spec_service::GetLocation {
        super::builder::encryption_spec_service::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EncryptionSpecService;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EncryptionSpecService
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::encryption_spec_service::ListOperations {
        super::builder::encryption_spec_service::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EncryptionSpecService;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EncryptionSpecService
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::encryption_spec_service::GetOperation {
        super::builder::encryption_spec_service::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EncryptionSpecService;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EncryptionSpecService
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::encryption_spec_service::CancelOperation {
        super::builder::encryption_spec_service::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::EntityTypes;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = EntityTypes::builder().build().await?;
///     let mut list = client.list_entity_types()
///         .set_parent(format!("projects/{project_id}/agent"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing [EntityTypes][google.cloud.dialogflow.v2.EntityType].
///
/// [google.cloud.dialogflow.v2.EntityType]: crate::model::EntityType
///
/// # Configuration
///
/// To configure `EntityTypes` use the `with_*` methods in the type returned
/// by [builder()][EntityTypes::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://dialogflow.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::entity_types::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::entity_types::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
///
/// `EntityTypes` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `EntityTypes` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "entity-types")]
#[cfg_attr(docsrs, doc(cfg(feature = "entity-types")))]
#[derive(Clone, Debug)]
pub struct EntityTypes {
    inner: std::sync::Arc<dyn super::stub::dynamic::EntityTypes>,
}

#[cfg(feature = "entity-types")]
impl EntityTypes {
    /// Returns a builder for [EntityTypes].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// let client = EntityTypes::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::entity_types::ClientBuilder {
        crate::new_client_builder(super::builder::entity_types::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::EntityTypes + '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::EntityTypes>> {
        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::EntityTypes> {
        super::transport::EntityTypes::new(conf).await
    }

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

    /// Returns the list of all entity types in the specified agent.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes, project_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_entity_types()
    ///         .set_parent(format!("projects/{project_id}/agent"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_entity_types(&self) -> super::builder::entity_types::ListEntityTypes {
        super::builder::entity_types::ListEntityTypes::new(self.inner.clone())
    }

    /// Retrieves the specified entity type.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes, project_id: &str, entity_type_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_entity_type()
    ///         .set_name(format!("projects/{project_id}/agent/entityTypes/{entity_type_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_entity_type(&self) -> super::builder::entity_types::GetEntityType {
        super::builder::entity_types::GetEntityType::new(self.inner.clone())
    }

    /// Creates an entity type in the specified agent.
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_dialogflow_v2::model::EntityType;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes, project_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_entity_type()
    ///         .set_parent(format!("projects/{project_id}/agent"))
    ///         .set_entity_type(
    ///             EntityType::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_entity_type(&self) -> super::builder::entity_types::CreateEntityType {
        super::builder::entity_types::CreateEntityType::new(self.inner.clone())
    }

    /// Updates the specified entity type.
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::EntityType;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes, project_id: &str, entity_type_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_entity_type()
    ///         .set_entity_type(
    ///             EntityType::new().set_name(format!("projects/{project_id}/agent/entityTypes/{entity_type_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_entity_type(&self) -> super::builder::entity_types::UpdateEntityType {
        super::builder::entity_types::UpdateEntityType::new(self.inner.clone())
    }

    /// Deletes the specified entity type.
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes, project_id: &str, entity_type_id: &str
    /// ) -> Result<()> {
    ///     client.delete_entity_type()
    ///         .set_name(format!("projects/{project_id}/agent/entityTypes/{entity_type_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_entity_type(&self) -> super::builder::entity_types::DeleteEntityType {
        super::builder::entity_types::DeleteEntityType::new(self.inner.clone())
    }

    /// Updates/Creates multiple entity types in the specified agent.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`:
    ///   [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// [google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]: crate::model::BatchUpdateEntityTypesResponse
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     let response = client.batch_update_entity_types()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn batch_update_entity_types(
        &self,
    ) -> super::builder::entity_types::BatchUpdateEntityTypes {
        super::builder::entity_types::BatchUpdateEntityTypes::new(self.inner.clone())
    }

    /// Deletes entity types in the specified agent.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     client.batch_delete_entity_types()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn batch_delete_entity_types(
        &self,
    ) -> super::builder::entity_types::BatchDeleteEntityTypes {
        super::builder::entity_types::BatchDeleteEntityTypes::new(self.inner.clone())
    }

    /// Creates multiple new entities in the specified entity type.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     client.batch_create_entities()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn batch_create_entities(&self) -> super::builder::entity_types::BatchCreateEntities {
        super::builder::entity_types::BatchCreateEntities::new(self.inner.clone())
    }

    /// Updates or creates multiple entities in the specified entity type. This
    /// method does not affect entities in the entity type that aren't explicitly
    /// specified in the request.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     client.batch_update_entities()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn batch_update_entities(&self) -> super::builder::entity_types::BatchUpdateEntities {
        super::builder::entity_types::BatchUpdateEntities::new(self.inner.clone())
    }

    /// Deletes entities in the specified entity type.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     client.batch_delete_entities()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn batch_delete_entities(&self) -> super::builder::entity_types::BatchDeleteEntities {
        super::builder::entity_types::BatchDeleteEntities::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::entity_types::ListLocations {
        super::builder::entity_types::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::entity_types::GetLocation {
        super::builder::entity_types::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::entity_types::ListOperations {
        super::builder::entity_types::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::entity_types::GetOperation {
        super::builder::entity_types::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::EntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &EntityTypes
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::entity_types::CancelOperation {
        super::builder::entity_types::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Environments;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = Environments::builder().build().await?;
///     let mut list = client.list_environments()
///         .set_parent(format!("projects/{project_id}/agent"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing [Environments][google.cloud.dialogflow.v2.Environment].
///
/// [google.cloud.dialogflow.v2.Environment]: crate::model::Environment
///
/// # Configuration
///
/// To configure `Environments` use the `with_*` methods in the type returned
/// by [builder()][Environments::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://dialogflow.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::environments::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::environments::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
///
/// `Environments` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Environments` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "environments")]
#[cfg_attr(docsrs, doc(cfg(feature = "environments")))]
#[derive(Clone, Debug)]
pub struct Environments {
    inner: std::sync::Arc<dyn super::stub::dynamic::Environments>,
}

#[cfg(feature = "environments")]
impl Environments {
    /// Returns a builder for [Environments].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// let client = Environments::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::environments::ClientBuilder {
        crate::new_client_builder(super::builder::environments::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::Environments + '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::Environments>> {
        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::Environments> {
        super::transport::Environments::new(conf).await
    }

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

    /// Returns the list of all non-default environments of the specified agent.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments, project_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_environments()
    ///         .set_parent(format!("projects/{project_id}/agent"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_environments(&self) -> super::builder::environments::ListEnvironments {
        super::builder::environments::ListEnvironments::new(self.inner.clone())
    }

    /// Retrieves the specified agent environment.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments, project_id: &str, environment_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_environment()
    ///         .set_name(format!("projects/{project_id}/agent/environments/{environment_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_environment(&self) -> super::builder::environments::GetEnvironment {
        super::builder::environments::GetEnvironment::new(self.inner.clone())
    }

    /// Creates an agent environment.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_dialogflow_v2::model::Environment;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments, project_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_environment()
    ///         .set_parent(format!("projects/{project_id}/agent"))
    ///         .set_environment_id("environment_id_value")
    ///         .set_environment(
    ///             Environment::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_environment(&self) -> super::builder::environments::CreateEnvironment {
        super::builder::environments::CreateEnvironment::new(self.inner.clone())
    }

    /// Updates the specified agent environment.
    ///
    /// This method allows you to deploy new agent versions into the environment.
    /// When an environment is pointed to a new agent version by setting
    /// `environment.agent_version`, the environment is temporarily set to the
    /// `LOADING` state. During that time, the environment continues serving the
    /// previous version of the agent. After the new agent version is done loading,
    /// the environment is set back to the `RUNNING` state.
    /// You can use "-" as Environment ID in environment name to update an agent
    /// version in the default environment. WARNING: this will negate all recent
    /// changes to the draft agent and can't be undone. You may want to save the
    /// draft agent to a version before calling this method.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::Environment;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments, project_id: &str, environment_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_environment()
    ///         .set_environment(
    ///             Environment::new().set_name(format!("projects/{project_id}/agent/environments/{environment_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_environment(&self) -> super::builder::environments::UpdateEnvironment {
        super::builder::environments::UpdateEnvironment::new(self.inner.clone())
    }

    /// Deletes the specified agent environment.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments, project_id: &str, environment_id: &str
    /// ) -> Result<()> {
    ///     client.delete_environment()
    ///         .set_name(format!("projects/{project_id}/agent/environments/{environment_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_environment(&self) -> super::builder::environments::DeleteEnvironment {
        super::builder::environments::DeleteEnvironment::new(self.inner.clone())
    }

    /// Gets the history of the specified environment.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments
    /// ) -> Result<()> {
    ///     let mut list = client.get_environment_history()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn get_environment_history(&self) -> super::builder::environments::GetEnvironmentHistory {
        super::builder::environments::GetEnvironmentHistory::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::environments::ListLocations {
        super::builder::environments::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::environments::GetLocation {
        super::builder::environments::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::environments::ListOperations {
        super::builder::environments::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::environments::GetOperation {
        super::builder::environments::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Environments;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Environments
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::environments::CancelOperation {
        super::builder::environments::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Fulfillments;
/// async fn sample(
///    project_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = Fulfillments::builder().build().await?;
///     let response = client.get_fulfillment()
///         .set_name(format!("projects/{project_id}/agent/fulfillment"))
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing [Fulfillments][google.cloud.dialogflow.v2.Fulfillment].
///
/// [google.cloud.dialogflow.v2.Fulfillment]: crate::model::Fulfillment
///
/// # Configuration
///
/// To configure `Fulfillments` use the `with_*` methods in the type returned
/// by [builder()][Fulfillments::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://dialogflow.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::fulfillments::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::fulfillments::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
///
/// `Fulfillments` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Fulfillments` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "fulfillments")]
#[cfg_attr(docsrs, doc(cfg(feature = "fulfillments")))]
#[derive(Clone, Debug)]
pub struct Fulfillments {
    inner: std::sync::Arc<dyn super::stub::dynamic::Fulfillments>,
}

#[cfg(feature = "fulfillments")]
impl Fulfillments {
    /// Returns a builder for [Fulfillments].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Fulfillments;
    /// let client = Fulfillments::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::fulfillments::ClientBuilder {
        crate::new_client_builder(super::builder::fulfillments::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::Fulfillments + '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::Fulfillments>> {
        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::Fulfillments> {
        super::transport::Fulfillments::new(conf).await
    }

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

    /// Retrieves the fulfillment.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Fulfillments;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Fulfillments, project_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_fulfillment()
    ///         .set_name(format!("projects/{project_id}/agent/fulfillment"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_fulfillment(&self) -> super::builder::fulfillments::GetFulfillment {
        super::builder::fulfillments::GetFulfillment::new(self.inner.clone())
    }

    /// Updates the fulfillment.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Fulfillments;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::Fulfillment;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Fulfillments, project_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_fulfillment()
    ///         .set_fulfillment(
    ///             Fulfillment::new().set_name(format!("projects/{project_id}/agent/fulfillment"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_fulfillment(&self) -> super::builder::fulfillments::UpdateFulfillment {
        super::builder::fulfillments::UpdateFulfillment::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Fulfillments;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Fulfillments
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::fulfillments::ListLocations {
        super::builder::fulfillments::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Fulfillments;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Fulfillments
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::fulfillments::GetLocation {
        super::builder::fulfillments::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Fulfillments;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Fulfillments
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::fulfillments::ListOperations {
        super::builder::fulfillments::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Fulfillments;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Fulfillments
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::fulfillments::GetOperation {
        super::builder::fulfillments::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Fulfillments;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Fulfillments
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::fulfillments::CancelOperation {
        super::builder::fulfillments::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Generators;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    parent: &str,
/// ) -> anyhow::Result<()> {
///     let client = Generators::builder().build().await?;
///     let mut list = client.list_generators()
///         .set_parent(parent)
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Generator Service for LLM powered Agent Assist. This service manages the
/// configurations of user owned Generators, such as description, context and
/// instruction, input/output format, etc. The generator resources will be used
/// inside a conversation and will be triggered by TriggerEvent to query LLM for
/// answers.
///
/// # Configuration
///
/// To configure `Generators` use the `with_*` methods in the type returned
/// by [builder()][Generators::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://dialogflow.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::generators::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::generators::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
///
/// `Generators` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Generators` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "generators")]
#[cfg_attr(docsrs, doc(cfg(feature = "generators")))]
#[derive(Clone, Debug)]
pub struct Generators {
    inner: std::sync::Arc<dyn super::stub::dynamic::Generators>,
}

#[cfg(feature = "generators")]
impl Generators {
    /// Returns a builder for [Generators].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// let client = Generators::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::generators::ClientBuilder {
        crate::new_client_builder(super::builder::generators::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::Generators + '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::Generators>> {
        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::Generators> {
        super::transport::Generators::new(conf).await
    }

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

    /// Creates a generator.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// use google_cloud_dialogflow_v2::model::Generator;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators, parent: &str
    /// ) -> Result<()> {
    ///     let response = client.create_generator()
    ///         .set_parent(parent)
    ///         .set_generator_id("generator_id_value")
    ///         .set_generator(
    ///             Generator::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_generator(&self) -> super::builder::generators::CreateGenerator {
        super::builder::generators::CreateGenerator::new(self.inner.clone())
    }

    /// Retrieves a generator.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators, project_id: &str, location_id: &str, generator_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_generator()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/generators/{generator_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_generator(&self) -> super::builder::generators::GetGenerator {
        super::builder::generators::GetGenerator::new(self.inner.clone())
    }

    /// Lists generators.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators, parent: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_generators()
    ///         .set_parent(parent)
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_generators(&self) -> super::builder::generators::ListGenerators {
        super::builder::generators::ListGenerators::new(self.inner.clone())
    }

    /// Deletes a generator.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators, project_id: &str, location_id: &str, generator_id: &str
    /// ) -> Result<()> {
    ///     client.delete_generator()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/generators/{generator_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_generator(&self) -> super::builder::generators::DeleteGenerator {
        super::builder::generators::DeleteGenerator::new(self.inner.clone())
    }

    /// Updates a generator.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::Generator;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators, project_id: &str, location_id: &str, generator_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_generator()
    ///         .set_generator(
    ///             Generator::new().set_name(format!("projects/{project_id}/locations/{location_id}/generators/{generator_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_generator(&self) -> super::builder::generators::UpdateGenerator {
        super::builder::generators::UpdateGenerator::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::generators::ListLocations {
        super::builder::generators::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::generators::GetLocation {
        super::builder::generators::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::generators::ListOperations {
        super::builder::generators::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::generators::GetOperation {
        super::builder::generators::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Generators;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Generators
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::generators::CancelOperation {
        super::builder::generators::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
///    location_id: &str,
///    generator_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = GeneratorEvaluations::builder().build().await?;
///     let mut list = client.list_generator_evaluations()
///         .set_parent(format!("projects/{project_id}/locations/{location_id}/generators/{generator_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing generator evaluations.
///
/// # Configuration
///
/// To configure `GeneratorEvaluations` use the `with_*` methods in the type returned
/// by [builder()][GeneratorEvaluations::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://dialogflow.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::generator_evaluations::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::generator_evaluations::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
///
/// `GeneratorEvaluations` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `GeneratorEvaluations` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "generator-evaluations")]
#[cfg_attr(docsrs, doc(cfg(feature = "generator-evaluations")))]
#[derive(Clone, Debug)]
pub struct GeneratorEvaluations {
    inner: std::sync::Arc<dyn super::stub::dynamic::GeneratorEvaluations>,
}

#[cfg(feature = "generator-evaluations")]
impl GeneratorEvaluations {
    /// Returns a builder for [GeneratorEvaluations].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// let client = GeneratorEvaluations::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::generator_evaluations::ClientBuilder {
        crate::new_client_builder(super::builder::generator_evaluations::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::GeneratorEvaluations + '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::GeneratorEvaluations>>
    {
        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::GeneratorEvaluations> {
        super::transport::GeneratorEvaluations::new(conf).await
    }

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

    /// Creates evaluation of a generator.
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::model::GeneratorEvaluation;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &GeneratorEvaluations, project_id: &str, location_id: &str, generator_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_generator_evaluation()
    ///         .set_parent(format!("projects/{project_id}/locations/{location_id}/generators/{generator_id}"))
    ///         .set_generator_evaluation(
    ///             GeneratorEvaluation::new()/* set fields */
    ///         )
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_generator_evaluation(
        &self,
    ) -> super::builder::generator_evaluations::CreateGeneratorEvaluation {
        super::builder::generator_evaluations::CreateGeneratorEvaluation::new(self.inner.clone())
    }

    /// Gets an evaluation of generator.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &GeneratorEvaluations, project_id: &str, location_id: &str, generator_id: &str, evaluation_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_generator_evaluation()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/generators/{generator_id}/evaluations/{evaluation_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_generator_evaluation(
        &self,
    ) -> super::builder::generator_evaluations::GetGeneratorEvaluation {
        super::builder::generator_evaluations::GetGeneratorEvaluation::new(self.inner.clone())
    }

    /// Lists evaluations of generator.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &GeneratorEvaluations, project_id: &str, location_id: &str, generator_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_generator_evaluations()
    ///         .set_parent(format!("projects/{project_id}/locations/{location_id}/generators/{generator_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_generator_evaluations(
        &self,
    ) -> super::builder::generator_evaluations::ListGeneratorEvaluations {
        super::builder::generator_evaluations::ListGeneratorEvaluations::new(self.inner.clone())
    }

    /// Deletes an evaluation of generator.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &GeneratorEvaluations, project_id: &str, location_id: &str, generator_id: &str, evaluation_id: &str
    /// ) -> Result<()> {
    ///     client.delete_generator_evaluation()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/generators/{generator_id}/evaluations/{evaluation_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_generator_evaluation(
        &self,
    ) -> super::builder::generator_evaluations::DeleteGeneratorEvaluation {
        super::builder::generator_evaluations::DeleteGeneratorEvaluation::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &GeneratorEvaluations
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::generator_evaluations::ListLocations {
        super::builder::generator_evaluations::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &GeneratorEvaluations
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::generator_evaluations::GetLocation {
        super::builder::generator_evaluations::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &GeneratorEvaluations
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::generator_evaluations::ListOperations {
        super::builder::generator_evaluations::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &GeneratorEvaluations
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::generator_evaluations::GetOperation {
        super::builder::generator_evaluations::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::GeneratorEvaluations;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &GeneratorEvaluations
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::generator_evaluations::CancelOperation {
        super::builder::generator_evaluations::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Intents;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = Intents::builder().build().await?;
///     let mut list = client.list_intents()
///         .set_parent(format!("projects/{project_id}/agent"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing [Intents][google.cloud.dialogflow.v2.Intent].
///
/// [google.cloud.dialogflow.v2.Intent]: crate::model::Intent
///
/// # Configuration
///
/// To configure `Intents` use the `with_*` methods in the type returned
/// by [builder()][Intents::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://dialogflow.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::intents::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::intents::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
///
/// `Intents` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Intents` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "intents")]
#[cfg_attr(docsrs, doc(cfg(feature = "intents")))]
#[derive(Clone, Debug)]
pub struct Intents {
    inner: std::sync::Arc<dyn super::stub::dynamic::Intents>,
}

#[cfg(feature = "intents")]
impl Intents {
    /// Returns a builder for [Intents].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// let client = Intents::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::intents::ClientBuilder {
        crate::new_client_builder(super::builder::intents::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::Intents + '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::Intents>> {
        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::Intents> {
        super::transport::Intents::new(conf).await
    }

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

    /// Returns the list of all intents in the specified agent.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents, project_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_intents()
    ///         .set_parent(format!("projects/{project_id}/agent"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_intents(&self) -> super::builder::intents::ListIntents {
        super::builder::intents::ListIntents::new(self.inner.clone())
    }

    /// Retrieves the specified intent.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents, project_id: &str, intent_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_intent()
    ///         .set_name(format!("projects/{project_id}/agent/intents/{intent_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_intent(&self) -> super::builder::intents::GetIntent {
        super::builder::intents::GetIntent::new(self.inner.clone())
    }

    /// Creates an intent in the specified agent.
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_dialogflow_v2::model::Intent;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents, project_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_intent()
    ///         .set_parent(format!("projects/{project_id}/agent"))
    ///         .set_intent(
    ///             Intent::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_intent(&self) -> super::builder::intents::CreateIntent {
        super::builder::intents::CreateIntent::new(self.inner.clone())
    }

    /// Updates the specified intent.
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::Intent;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents, project_id: &str, intent_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_intent()
    ///         .set_intent(
    ///             Intent::new().set_name(format!("projects/{project_id}/agent/intents/{intent_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_intent(&self) -> super::builder::intents::UpdateIntent {
        super::builder::intents::UpdateIntent::new(self.inner.clone())
    }

    /// Deletes the specified intent and its direct or indirect followup intents.
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents, project_id: &str, intent_id: &str
    /// ) -> Result<()> {
    ///     client.delete_intent()
    ///         .set_name(format!("projects/{project_id}/agent/intents/{intent_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_intent(&self) -> super::builder::intents::DeleteIntent {
        super::builder::intents::DeleteIntent::new(self.inner.clone())
    }

    /// Updates/Creates multiple intents in the specified agent.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`:
    ///   [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// [google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]: crate::model::BatchUpdateIntentsResponse
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents
    /// ) -> Result<()> {
    ///     let response = client.batch_update_intents()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn batch_update_intents(&self) -> super::builder::intents::BatchUpdateIntents {
        super::builder::intents::BatchUpdateIntents::new(self.inner.clone())
    }

    /// Deletes intents in the specified agent.
    ///
    /// This method is a [long-running
    /// operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-operations).
    /// The returned `Operation` type has the following method-specific fields:
    ///
    /// - `metadata`: An empty [Struct
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
    /// - `response`: An [Empty
    ///   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
    ///
    /// Note: You should always train an agent prior to sending it queries. See the
    /// [training
    /// documentation](https://cloud.google.com/dialogflow/es/docs/training).
    ///
    /// # Long running operations
    ///
    /// This method is used to start, and/or poll a [long-running Operation].
    /// The [Working with long-running operations] chapter in the [user guide]
    /// covers these operations in detail.
    ///
    /// [long-running operation]: https://google.aip.dev/151
    /// [user guide]: https://googleapis.github.io/google-cloud-rust/
    /// [working with long-running operations]: https://googleapis.github.io/google-cloud-rust/working_with_long_running_operations.html
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_lro::Poller;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents
    /// ) -> Result<()> {
    ///     client.batch_delete_intents()
    ///         /* set fields */
    ///         .poller().until_done().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn batch_delete_intents(&self) -> super::builder::intents::BatchDeleteIntents {
        super::builder::intents::BatchDeleteIntents::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::intents::ListLocations {
        super::builder::intents::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::intents::GetLocation {
        super::builder::intents::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::intents::ListOperations {
        super::builder::intents::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::intents::GetOperation {
        super::builder::intents::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Intents;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Intents
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::intents::CancelOperation {
        super::builder::intents::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = KnowledgeBases::builder().build().await?;
///     let mut list = client.list_knowledge_bases()
///         .set_parent(format!("projects/{project_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing
/// [KnowledgeBases][google.cloud.dialogflow.v2.KnowledgeBase].
///
/// [google.cloud.dialogflow.v2.KnowledgeBase]: crate::model::KnowledgeBase
///
/// # Configuration
///
/// To configure `KnowledgeBases` use the `with_*` methods in the type returned
/// by [builder()][KnowledgeBases::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://dialogflow.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::knowledge_bases::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::knowledge_bases::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
///
/// `KnowledgeBases` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `KnowledgeBases` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "knowledge-bases")]
#[cfg_attr(docsrs, doc(cfg(feature = "knowledge-bases")))]
#[derive(Clone, Debug)]
pub struct KnowledgeBases {
    inner: std::sync::Arc<dyn super::stub::dynamic::KnowledgeBases>,
}

#[cfg(feature = "knowledge-bases")]
impl KnowledgeBases {
    /// Returns a builder for [KnowledgeBases].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// let client = KnowledgeBases::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::knowledge_bases::ClientBuilder {
        crate::new_client_builder(super::builder::knowledge_bases::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::KnowledgeBases + '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::KnowledgeBases>> {
        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::KnowledgeBases> {
        super::transport::KnowledgeBases::new(conf).await
    }

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

    /// Returns the list of all knowledge bases of the specified agent.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases, project_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_knowledge_bases()
    ///         .set_parent(format!("projects/{project_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_knowledge_bases(&self) -> super::builder::knowledge_bases::ListKnowledgeBases {
        super::builder::knowledge_bases::ListKnowledgeBases::new(self.inner.clone())
    }

    /// Retrieves the specified knowledge base.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases, project_id: &str, knowledge_base_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_knowledge_base()
    ///         .set_name(format!("projects/{project_id}/knowledgeBases/{knowledge_base_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_knowledge_base(&self) -> super::builder::knowledge_bases::GetKnowledgeBase {
        super::builder::knowledge_bases::GetKnowledgeBase::new(self.inner.clone())
    }

    /// Creates a knowledge base.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// use google_cloud_dialogflow_v2::model::KnowledgeBase;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases, project_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_knowledge_base()
    ///         .set_parent(format!("projects/{project_id}"))
    ///         .set_knowledge_base(
    ///             KnowledgeBase::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_knowledge_base(&self) -> super::builder::knowledge_bases::CreateKnowledgeBase {
        super::builder::knowledge_bases::CreateKnowledgeBase::new(self.inner.clone())
    }

    /// Deletes the specified knowledge base.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases, project_id: &str, knowledge_base_id: &str
    /// ) -> Result<()> {
    ///     client.delete_knowledge_base()
    ///         .set_name(format!("projects/{project_id}/knowledgeBases/{knowledge_base_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_knowledge_base(&self) -> super::builder::knowledge_bases::DeleteKnowledgeBase {
        super::builder::knowledge_bases::DeleteKnowledgeBase::new(self.inner.clone())
    }

    /// Updates the specified knowledge base.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::KnowledgeBase;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases, project_id: &str, knowledge_base_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_knowledge_base()
    ///         .set_knowledge_base(
    ///             KnowledgeBase::new().set_name(format!("projects/{project_id}/knowledgeBases/{knowledge_base_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_knowledge_base(&self) -> super::builder::knowledge_bases::UpdateKnowledgeBase {
        super::builder::knowledge_bases::UpdateKnowledgeBase::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::knowledge_bases::ListLocations {
        super::builder::knowledge_bases::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::knowledge_bases::GetLocation {
        super::builder::knowledge_bases::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::knowledge_bases::ListOperations {
        super::builder::knowledge_bases::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::knowledge_bases::GetOperation {
        super::builder::knowledge_bases::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::KnowledgeBases;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &KnowledgeBases
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::knowledge_bases::CancelOperation {
        super::builder::knowledge_bases::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Participants;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
///    conversation_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = Participants::builder().build().await?;
///     let mut list = client.list_participants()
///         .set_parent(format!("projects/{project_id}/conversations/{conversation_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing [Participants][google.cloud.dialogflow.v2.Participant].
///
/// [google.cloud.dialogflow.v2.Participant]: crate::model::Participant
///
/// # Configuration
///
/// To configure `Participants` use the `with_*` methods in the type returned
/// by [builder()][Participants::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://dialogflow.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::participants::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::participants::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
///
/// `Participants` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Participants` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "participants")]
#[cfg_attr(docsrs, doc(cfg(feature = "participants")))]
#[derive(Clone, Debug)]
pub struct Participants {
    inner: std::sync::Arc<dyn super::stub::dynamic::Participants>,
}

#[cfg(feature = "participants")]
impl Participants {
    /// Returns a builder for [Participants].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// let client = Participants::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::participants::ClientBuilder {
        crate::new_client_builder(super::builder::participants::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::Participants + '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::Participants>> {
        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::Participants> {
        super::transport::Participants::new(conf).await
    }

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

    /// Creates a new participant in a conversation.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::model::Participant;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants, project_id: &str, conversation_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_participant()
    ///         .set_parent(format!("projects/{project_id}/conversations/{conversation_id}"))
    ///         .set_participant(
    ///             Participant::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_participant(&self) -> super::builder::participants::CreateParticipant {
        super::builder::participants::CreateParticipant::new(self.inner.clone())
    }

    /// Retrieves a conversation participant.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants, project_id: &str, conversation_id: &str, participant_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_participant()
    ///         .set_name(format!("projects/{project_id}/conversations/{conversation_id}/participants/{participant_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_participant(&self) -> super::builder::participants::GetParticipant {
        super::builder::participants::GetParticipant::new(self.inner.clone())
    }

    /// Returns the list of all participants in the specified conversation.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants, project_id: &str, conversation_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_participants()
    ///         .set_parent(format!("projects/{project_id}/conversations/{conversation_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_participants(&self) -> super::builder::participants::ListParticipants {
        super::builder::participants::ListParticipants::new(self.inner.clone())
    }

    /// Updates the specified participant.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::Participant;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants, project_id: &str, conversation_id: &str, participant_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_participant()
    ///         .set_participant(
    ///             Participant::new().set_name(format!("projects/{project_id}/conversations/{conversation_id}/participants/{participant_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_participant(&self) -> super::builder::participants::UpdateParticipant {
        super::builder::participants::UpdateParticipant::new(self.inner.clone())
    }

    /// Adds a text (chat, for example), or audio (phone recording, for example)
    /// message from a participant into the conversation.
    ///
    /// Note: Always use agent versions for production traffic
    /// sent to virtual agents. See [Versions and
    /// environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     let response = client.analyze_content()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn analyze_content(&self) -> super::builder::participants::AnalyzeContent {
        super::builder::participants::AnalyzeContent::new(self.inner.clone())
    }

    /// Gets suggested articles for a participant based on specific historical
    /// messages.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     let response = client.suggest_articles()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn suggest_articles(&self) -> super::builder::participants::SuggestArticles {
        super::builder::participants::SuggestArticles::new(self.inner.clone())
    }

    /// Gets suggested faq answers for a participant based on specific historical
    /// messages.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     let response = client.suggest_faq_answers()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn suggest_faq_answers(&self) -> super::builder::participants::SuggestFaqAnswers {
        super::builder::participants::SuggestFaqAnswers::new(self.inner.clone())
    }

    /// Gets smart replies for a participant based on specific historical
    /// messages.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     let response = client.suggest_smart_replies()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn suggest_smart_replies(&self) -> super::builder::participants::SuggestSmartReplies {
        super::builder::participants::SuggestSmartReplies::new(self.inner.clone())
    }

    /// Gets knowledge assist suggestions based on historical messages.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     let response = client.suggest_knowledge_assist()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn suggest_knowledge_assist(&self) -> super::builder::participants::SuggestKnowledgeAssist {
        super::builder::participants::SuggestKnowledgeAssist::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::participants::ListLocations {
        super::builder::participants::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::participants::GetLocation {
        super::builder::participants::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::participants::ListOperations {
        super::builder::participants::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::participants::GetOperation {
        super::builder::participants::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Participants;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Participants
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::participants::CancelOperation {
        super::builder::participants::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Sessions;
/// async fn sample(
/// ) -> anyhow::Result<()> {
///     let client = Sessions::builder().build().await?;
///     let response = client.detect_intent()
///         /* set fields */
///         .send().await?;
///     println!("response {:?}", response);
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// A service used for session interactions.
///
/// For more information, see the [API interactions
/// guide](https://cloud.google.com/dialogflow/docs/api-overview).
///
/// # Configuration
///
/// To configure `Sessions` use the `with_*` methods in the type returned
/// by [builder()][Sessions::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://dialogflow.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::sessions::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::sessions::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
///
/// `Sessions` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Sessions` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "sessions")]
#[cfg_attr(docsrs, doc(cfg(feature = "sessions")))]
#[derive(Clone, Debug)]
pub struct Sessions {
    inner: std::sync::Arc<dyn super::stub::dynamic::Sessions>,
}

#[cfg(feature = "sessions")]
impl Sessions {
    /// Returns a builder for [Sessions].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Sessions;
    /// let client = Sessions::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::sessions::ClientBuilder {
        crate::new_client_builder(super::builder::sessions::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::Sessions + '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::Sessions>> {
        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::Sessions> {
        super::transport::Sessions::new(conf).await
    }

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

    /// Processes a natural language query and returns structured, actionable data
    /// as a result. This method is not idempotent, because it may cause contexts
    /// and session entity types to be updated, which in turn might affect
    /// results of future queries.
    ///
    /// If you might use
    /// [Agent Assist](https://cloud.google.com/dialogflow/docs/#aa)
    /// or other CCAI products now or in the future, consider using
    /// [AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent]
    /// instead of `DetectIntent`. `AnalyzeContent` has additional
    /// functionality for Agent Assist and other CCAI products.
    ///
    /// Note: Always use agent versions for production traffic.
    /// See [Versions and
    /// environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
    ///
    /// [google.cloud.dialogflow.v2.Participants.AnalyzeContent]: crate::client::Participants::analyze_content
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Sessions;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Sessions
    /// ) -> Result<()> {
    ///     let response = client.detect_intent()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn detect_intent(&self) -> super::builder::sessions::DetectIntent {
        super::builder::sessions::DetectIntent::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Sessions;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Sessions
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::sessions::ListLocations {
        super::builder::sessions::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Sessions;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Sessions
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::sessions::GetLocation {
        super::builder::sessions::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Sessions;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Sessions
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::sessions::ListOperations {
        super::builder::sessions::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Sessions;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Sessions
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::sessions::GetOperation {
        super::builder::sessions::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Sessions;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Sessions
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::sessions::CancelOperation {
        super::builder::sessions::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
///    session_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = SessionEntityTypes::builder().build().await?;
///     let mut list = client.list_session_entity_types()
///         .set_parent(format!("projects/{project_id}/agent/sessions/{session_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing
/// [SessionEntityTypes][google.cloud.dialogflow.v2.SessionEntityType].
///
/// [google.cloud.dialogflow.v2.SessionEntityType]: crate::model::SessionEntityType
///
/// # Configuration
///
/// To configure `SessionEntityTypes` use the `with_*` methods in the type returned
/// by [builder()][SessionEntityTypes::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://dialogflow.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::session_entity_types::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::session_entity_types::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
///
/// `SessionEntityTypes` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `SessionEntityTypes` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "session-entity-types")]
#[cfg_attr(docsrs, doc(cfg(feature = "session-entity-types")))]
#[derive(Clone, Debug)]
pub struct SessionEntityTypes {
    inner: std::sync::Arc<dyn super::stub::dynamic::SessionEntityTypes>,
}

#[cfg(feature = "session-entity-types")]
impl SessionEntityTypes {
    /// Returns a builder for [SessionEntityTypes].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// let client = SessionEntityTypes::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::session_entity_types::ClientBuilder {
        crate::new_client_builder(super::builder::session_entity_types::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::SessionEntityTypes + '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::SessionEntityTypes>>
    {
        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::SessionEntityTypes> {
        super::transport::SessionEntityTypes::new(conf).await
    }

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

    /// Returns the list of all session entity types in the specified session.
    ///
    /// This method doesn't work with Google Assistant integration.
    /// Contact Dialogflow support if you need to use session entities
    /// with Google Assistant integration.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes, project_id: &str, session_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_session_entity_types()
    ///         .set_parent(format!("projects/{project_id}/agent/sessions/{session_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_session_entity_types(
        &self,
    ) -> super::builder::session_entity_types::ListSessionEntityTypes {
        super::builder::session_entity_types::ListSessionEntityTypes::new(self.inner.clone())
    }

    /// Retrieves the specified session entity type.
    ///
    /// This method doesn't work with Google Assistant integration.
    /// Contact Dialogflow support if you need to use session entities
    /// with Google Assistant integration.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes, project_id: &str, session_id: &str, entity_type_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_session_entity_type()
    ///         .set_name(format!("projects/{project_id}/agent/sessions/{session_id}/entityTypes/{entity_type_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_session_entity_type(
        &self,
    ) -> super::builder::session_entity_types::GetSessionEntityType {
        super::builder::session_entity_types::GetSessionEntityType::new(self.inner.clone())
    }

    /// Creates a session entity type.
    ///
    /// If the specified session entity type already exists, overrides the session
    /// entity type.
    ///
    /// This method doesn't work with Google Assistant integration.
    /// Contact Dialogflow support if you need to use session entities
    /// with Google Assistant integration.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// use google_cloud_dialogflow_v2::model::SessionEntityType;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes, project_id: &str, session_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_session_entity_type()
    ///         .set_parent(format!("projects/{project_id}/agent/sessions/{session_id}"))
    ///         .set_session_entity_type(
    ///             SessionEntityType::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_session_entity_type(
        &self,
    ) -> super::builder::session_entity_types::CreateSessionEntityType {
        super::builder::session_entity_types::CreateSessionEntityType::new(self.inner.clone())
    }

    /// Updates the specified session entity type.
    ///
    /// This method doesn't work with Google Assistant integration.
    /// Contact Dialogflow support if you need to use session entities
    /// with Google Assistant integration.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::SessionEntityType;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes, project_id: &str, session_id: &str, entity_type_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_session_entity_type()
    ///         .set_session_entity_type(
    ///             SessionEntityType::new().set_name(format!("projects/{project_id}/agent/sessions/{session_id}/entityTypes/{entity_type_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_session_entity_type(
        &self,
    ) -> super::builder::session_entity_types::UpdateSessionEntityType {
        super::builder::session_entity_types::UpdateSessionEntityType::new(self.inner.clone())
    }

    /// Deletes the specified session entity type.
    ///
    /// This method doesn't work with Google Assistant integration.
    /// Contact Dialogflow support if you need to use session entities
    /// with Google Assistant integration.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes, project_id: &str, session_id: &str, entity_type_id: &str
    /// ) -> Result<()> {
    ///     client.delete_session_entity_type()
    ///         .set_name(format!("projects/{project_id}/agent/sessions/{session_id}/entityTypes/{entity_type_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_session_entity_type(
        &self,
    ) -> super::builder::session_entity_types::DeleteSessionEntityType {
        super::builder::session_entity_types::DeleteSessionEntityType::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::session_entity_types::ListLocations {
        super::builder::session_entity_types::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::session_entity_types::GetLocation {
        super::builder::session_entity_types::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::session_entity_types::ListOperations {
        super::builder::session_entity_types::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::session_entity_types::GetOperation {
        super::builder::session_entity_types::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SessionEntityTypes;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SessionEntityTypes
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::session_entity_types::CancelOperation {
        super::builder::session_entity_types::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::SipTrunks;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
///    location_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = SipTrunks::builder().build().await?;
///     let mut list = client.list_sip_trunks()
///         .set_parent(format!("projects/{project_id}/locations/{location_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing [SipTrunks][google.cloud.dialogflow.v2.SipTrunk].
///
/// [google.cloud.dialogflow.v2.SipTrunk]: crate::model::SipTrunk
///
/// # Configuration
///
/// To configure `SipTrunks` use the `with_*` methods in the type returned
/// by [builder()][SipTrunks::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://dialogflow.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::sip_trunks::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::sip_trunks::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
///
/// `SipTrunks` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `SipTrunks` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "sip-trunks")]
#[cfg_attr(docsrs, doc(cfg(feature = "sip-trunks")))]
#[derive(Clone, Debug)]
pub struct SipTrunks {
    inner: std::sync::Arc<dyn super::stub::dynamic::SipTrunks>,
}

#[cfg(feature = "sip-trunks")]
impl SipTrunks {
    /// Returns a builder for [SipTrunks].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// let client = SipTrunks::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::sip_trunks::ClientBuilder {
        crate::new_client_builder(super::builder::sip_trunks::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::SipTrunks + '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::SipTrunks>> {
        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::SipTrunks> {
        super::transport::SipTrunks::new(conf).await
    }

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

    /// Creates a SipTrunk for a specified location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// use google_cloud_dialogflow_v2::model::SipTrunk;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks, project_id: &str, location_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_sip_trunk()
    ///         .set_parent(format!("projects/{project_id}/locations/{location_id}"))
    ///         .set_sip_trunk(
    ///             SipTrunk::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_sip_trunk(&self) -> super::builder::sip_trunks::CreateSipTrunk {
        super::builder::sip_trunks::CreateSipTrunk::new(self.inner.clone())
    }

    /// Deletes a specified SipTrunk.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks, project_id: &str, location_id: &str, siptrunk_id: &str
    /// ) -> Result<()> {
    ///     client.delete_sip_trunk()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/sipTrunks/{siptrunk_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_sip_trunk(&self) -> super::builder::sip_trunks::DeleteSipTrunk {
        super::builder::sip_trunks::DeleteSipTrunk::new(self.inner.clone())
    }

    /// Returns a list of SipTrunks in the specified location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks, project_id: &str, location_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_sip_trunks()
    ///         .set_parent(format!("projects/{project_id}/locations/{location_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_sip_trunks(&self) -> super::builder::sip_trunks::ListSipTrunks {
        super::builder::sip_trunks::ListSipTrunks::new(self.inner.clone())
    }

    /// Retrieves the specified SipTrunk.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks, project_id: &str, location_id: &str, siptrunk_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_sip_trunk()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/sipTrunks/{siptrunk_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_sip_trunk(&self) -> super::builder::sip_trunks::GetSipTrunk {
        super::builder::sip_trunks::GetSipTrunk::new(self.inner.clone())
    }

    /// Updates the specified SipTrunk.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::SipTrunk;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks, project_id: &str, location_id: &str, siptrunk_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_sip_trunk()
    ///         .set_sip_trunk(
    ///             SipTrunk::new().set_name(format!("projects/{project_id}/locations/{location_id}/sipTrunks/{siptrunk_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_sip_trunk(&self) -> super::builder::sip_trunks::UpdateSipTrunk {
        super::builder::sip_trunks::UpdateSipTrunk::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::sip_trunks::ListLocations {
        super::builder::sip_trunks::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::sip_trunks::GetLocation {
        super::builder::sip_trunks::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::sip_trunks::ListOperations {
        super::builder::sip_trunks::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::sip_trunks::GetOperation {
        super::builder::sip_trunks::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::SipTrunks;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &SipTrunks
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::sip_trunks::CancelOperation {
        super::builder::sip_trunks::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Tools;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
///    location_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = Tools::builder().build().await?;
///     let mut list = client.list_tools()
///         .set_parent(format!("projects/{project_id}/locations/{location_id}"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Tool Service for LLM powered Agent Assist. Tools can be used to interact with
/// remote APIs (e.g. fetching orders) to retrieve additional information as
/// input to LLM.
///
/// # Configuration
///
/// To configure `Tools` use the `with_*` methods in the type returned
/// by [builder()][Tools::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://dialogflow.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::tools::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::tools::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
///
/// `Tools` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Tools` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "tools")]
#[cfg_attr(docsrs, doc(cfg(feature = "tools")))]
#[derive(Clone, Debug)]
pub struct Tools {
    inner: std::sync::Arc<dyn super::stub::dynamic::Tools>,
}

#[cfg(feature = "tools")]
impl Tools {
    /// Returns a builder for [Tools].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// let client = Tools::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::tools::ClientBuilder {
        crate::new_client_builder(super::builder::tools::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::Tools + '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::Tools>> {
        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::Tools> {
        super::transport::Tools::new(conf).await
    }

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

    /// Creates a tool.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// use google_cloud_dialogflow_v2::model::Tool;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools, project_id: &str, location_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_tool()
    ///         .set_parent(format!("projects/{project_id}/locations/{location_id}"))
    ///         .set_tool_id("tool_id_value")
    ///         .set_tool(
    ///             Tool::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_tool(&self) -> super::builder::tools::CreateTool {
        super::builder::tools::CreateTool::new(self.inner.clone())
    }

    /// Retrieves a tool.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools, project_id: &str, location_id: &str, tool_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_tool()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/tools/{tool_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_tool(&self) -> super::builder::tools::GetTool {
        super::builder::tools::GetTool::new(self.inner.clone())
    }

    /// Lists tools.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools, project_id: &str, location_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_tools()
    ///         .set_parent(format!("projects/{project_id}/locations/{location_id}"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_tools(&self) -> super::builder::tools::ListTools {
        super::builder::tools::ListTools::new(self.inner.clone())
    }

    /// Deletes a tool.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools, project_id: &str, location_id: &str, tool_id: &str
    /// ) -> Result<()> {
    ///     client.delete_tool()
    ///         .set_name(format!("projects/{project_id}/locations/{location_id}/tools/{tool_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_tool(&self) -> super::builder::tools::DeleteTool {
        super::builder::tools::DeleteTool::new(self.inner.clone())
    }

    /// Updates a tool.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::Tool;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools, project_id: &str, location_id: &str, tool_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_tool()
    ///         .set_tool(
    ///             Tool::new().set_name(format!("projects/{project_id}/locations/{location_id}/tools/{tool_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_tool(&self) -> super::builder::tools::UpdateTool {
        super::builder::tools::UpdateTool::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::tools::ListLocations {
        super::builder::tools::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::tools::GetLocation {
        super::builder::tools::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::tools::ListOperations {
        super::builder::tools::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::tools::GetOperation {
        super::builder::tools::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Tools;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Tools
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::tools::CancelOperation {
        super::builder::tools::CancelOperation::new(self.inner.clone())
    }
}

/// Implements a client for the Dialogflow API.
///
/// # Example
/// ```
/// # use google_cloud_dialogflow_v2::client::Versions;
/// use google_cloud_gax::paginator::ItemPaginator as _;
/// async fn sample(
///    project_id: &str,
/// ) -> anyhow::Result<()> {
///     let client = Versions::builder().build().await?;
///     let mut list = client.list_versions()
///         .set_parent(format!("projects/{project_id}/agent"))
///         .by_item();
///     while let Some(item) = list.next().await.transpose()? {
///         println!("{:?}", item);
///     }
///     Ok(())
/// }
/// ```
///
/// # Service Description
///
/// Service for managing [Versions][google.cloud.dialogflow.v2.Version].
///
/// [google.cloud.dialogflow.v2.Version]: crate::model::Version
///
/// # Configuration
///
/// To configure `Versions` use the `with_*` methods in the type returned
/// by [builder()][Versions::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://dialogflow.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::versions::ClientBuilder::with_endpoint
/// [with_credentials()]: super::builder::versions::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
///
/// `Versions` holds a connection pool internally, it is advised to
/// create one and reuse it. You do not need to wrap `Versions` in
/// an [Rc](std::rc::Rc) or [Arc](std::sync::Arc) to reuse it, because it
/// already uses an `Arc` internally.
#[cfg(feature = "versions")]
#[cfg_attr(docsrs, doc(cfg(feature = "versions")))]
#[derive(Clone, Debug)]
pub struct Versions {
    inner: std::sync::Arc<dyn super::stub::dynamic::Versions>,
}

#[cfg(feature = "versions")]
impl Versions {
    /// Returns a builder for [Versions].
    ///
    /// ```
    /// # async fn sample() -> google_cloud_gax::client_builder::Result<()> {
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// let client = Versions::builder().build().await?;
    /// # Ok(()) }
    /// ```
    pub fn builder() -> super::builder::versions::ClientBuilder {
        crate::new_client_builder(super::builder::versions::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::Versions + '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::Versions>> {
        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::Versions> {
        super::transport::Versions::new(conf).await
    }

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

    /// Returns the list of all versions of the specified agent.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions, project_id: &str
    /// ) -> Result<()> {
    ///     let mut list = client.list_versions()
    ///         .set_parent(format!("projects/{project_id}/agent"))
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_versions(&self) -> super::builder::versions::ListVersions {
        super::builder::versions::ListVersions::new(self.inner.clone())
    }

    /// Retrieves the specified agent version.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions, project_id: &str, version_id: &str
    /// ) -> Result<()> {
    ///     let response = client.get_version()
    ///         .set_name(format!("projects/{project_id}/agent/versions/{version_id}"))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_version(&self) -> super::builder::versions::GetVersion {
        super::builder::versions::GetVersion::new(self.inner.clone())
    }

    /// Creates an agent version.
    ///
    /// The new version points to the agent instance in the "default" environment.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// use google_cloud_dialogflow_v2::model::Version;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions, project_id: &str
    /// ) -> Result<()> {
    ///     let response = client.create_version()
    ///         .set_parent(format!("projects/{project_id}/agent"))
    ///         .set_version(
    ///             Version::new()/* set fields */
    ///         )
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn create_version(&self) -> super::builder::versions::CreateVersion {
        super::builder::versions::CreateVersion::new(self.inner.clone())
    }

    /// Updates the specified agent version.
    ///
    /// Note that this method does not allow you to update the state of the agent
    /// the given version points to. It allows you to update only mutable
    /// properties of the version resource.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// # extern crate wkt as google_cloud_wkt;
    /// use google_cloud_wkt::FieldMask;
    /// use google_cloud_dialogflow_v2::model::Version;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions, project_id: &str, version_id: &str
    /// ) -> Result<()> {
    ///     let response = client.update_version()
    ///         .set_version(
    ///             Version::new().set_name(format!("projects/{project_id}/agent/versions/{version_id}"))/* set fields */
    ///         )
    ///         .set_update_mask(FieldMask::default().set_paths(["updated.field.path1", "updated.field.path2"]))
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn update_version(&self) -> super::builder::versions::UpdateVersion {
        super::builder::versions::UpdateVersion::new(self.inner.clone())
    }

    /// Delete the specified agent version.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions, project_id: &str, version_id: &str
    /// ) -> Result<()> {
    ///     client.delete_version()
    ///         .set_name(format!("projects/{project_id}/agent/versions/{version_id}"))
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn delete_version(&self) -> super::builder::versions::DeleteVersion {
        super::builder::versions::DeleteVersion::new(self.inner.clone())
    }

    /// Lists information about the supported locations for this service.
    ///
    /// This method lists locations based on the resource scope provided in
    /// the [ListLocationsRequest.name][google.cloud.location.ListLocationsRequest.name] field: *
    /// **Global locations**: If `name` is empty, the method lists the
    /// public locations available to all projects. * **Project-specific
    /// locations**: If `name` follows the format
    /// `projects/{project}`, the method lists locations visible to that
    /// specific project. This includes public, private, or other
    /// project-specific locations enabled for the project.
    ///
    /// For gRPC and client library implementations, the resource name is
    /// passed as the `name` field. For direct service calls, the resource
    /// name is
    /// incorporated into the request path based on the specific service
    /// implementation and version.
    ///
    /// [google.cloud.location.ListLocationsRequest.name]: google_cloud_location::model::ListLocationsRequest::name
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions
    /// ) -> Result<()> {
    ///     let mut list = client.list_locations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_locations(&self) -> super::builder::versions::ListLocations {
        super::builder::versions::ListLocations::new(self.inner.clone())
    }

    /// Gets information about a location.
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions
    /// ) -> Result<()> {
    ///     let response = client.get_location()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_location(&self) -> super::builder::versions::GetLocation {
        super::builder::versions::GetLocation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// use google_cloud_gax::paginator::ItemPaginator as _;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions
    /// ) -> Result<()> {
    ///     let mut list = client.list_operations()
    ///         /* set fields */
    ///         .by_item();
    ///     while let Some(item) = list.next().await.transpose()? {
    ///         println!("{:?}", item);
    ///     }
    ///     Ok(())
    /// }
    /// ```
    pub fn list_operations(&self) -> super::builder::versions::ListOperations {
        super::builder::versions::ListOperations::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions
    /// ) -> Result<()> {
    ///     let response = client.get_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     println!("response {:?}", response);
    ///     Ok(())
    /// }
    /// ```
    pub fn get_operation(&self) -> super::builder::versions::GetOperation {
        super::builder::versions::GetOperation::new(self.inner.clone())
    }

    /// Provides the [Operations][google.longrunning.Operations] service functionality in this service.
    ///
    /// [google.longrunning.Operations]: google-cloud-longrunning::client::Operations
    ///
    /// # Example
    /// ```
    /// # use google_cloud_dialogflow_v2::client::Versions;
    /// use google_cloud_dialogflow_v2::Result;
    /// async fn sample(
    ///    client: &Versions
    /// ) -> Result<()> {
    ///     client.cancel_operation()
    ///         /* set fields */
    ///         .send().await?;
    ///     Ok(())
    /// }
    /// ```
    pub fn cancel_operation(&self) -> super::builder::versions::CancelOperation {
        super::builder::versions::CancelOperation::new(self.inner.clone())
    }
}