google_cloud_trace_v2/

model.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::redundant_explicit_links)]
#![allow(rustdoc::broken_intra_doc_links)]
#![no_implicit_prelude]
extern crate async_trait;
extern crate bytes;
extern crate gaxi;
extern crate google_cloud_gax;
extern crate google_cloud_rpc;
extern crate serde;
extern crate serde_json;
extern crate serde_with;
extern crate std;
extern crate tracing;
extern crate wkt;

mod debug;
mod deserialize;
mod serialize;

/// A span represents a single operation within a trace. Spans can be
/// nested to form a trace tree. Often, a trace contains a root span
/// that describes the end-to-end latency, and one or more subspans for
/// its sub-operations.
///
/// A trace can also contain multiple root spans, or none at all.
/// Spans do not need to be contiguous. There might be
/// gaps or overlaps between spans in a trace.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Span {
    /// Required. The resource name of the span in the following format:
    ///
    /// * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
    ///
    /// `[TRACE_ID]` is a unique identifier for a trace within a project;
    /// it is a 32-character hexadecimal encoding of a 16-byte array. It should
    /// not be zero.
    ///
    /// `[SPAN_ID]` is a unique identifier for a span within a trace; it
    /// is a 16-character hexadecimal encoding of an 8-byte array. It should not
    /// be zero.
    /// .
    pub name: std::string::String,

    /// Required. The `[SPAN_ID]` portion of the span's resource name.
    pub span_id: std::string::String,

    /// The `[SPAN_ID]` of this span's parent span. If this is a root span,
    /// then this field must be empty.
    pub parent_span_id: std::string::String,

    /// Required. A description of the span's operation (up to 128 bytes).
    /// Cloud Trace displays the description in the
    /// Cloud console.
    /// For example, the display name can be a qualified method name or a file name
    /// and a line number where the operation is called. A best practice is to use
    /// the same display name within an application and at the same call point.
    /// This makes it easier to correlate spans in different traces.
    pub display_name: std::option::Option<crate::model::TruncatableString>,

    /// Required. The start time of the span. On the client side, this is the time
    /// kept by the local machine where the span execution starts. On the server
    /// side, this is the time when the server's application handler starts
    /// running.
    pub start_time: std::option::Option<wkt::Timestamp>,

    /// Required. The end time of the span. On the client side, this is the time
    /// kept by the local machine where the span execution ends. On the server
    /// side, this is the time when the server application handler stops running.
    pub end_time: std::option::Option<wkt::Timestamp>,

    /// A set of attributes on the span. You can have up to 32 attributes per
    /// span.
    pub attributes: std::option::Option<crate::model::span::Attributes>,

    /// Stack trace captured at the start of the span.
    pub stack_trace: std::option::Option<crate::model::StackTrace>,

    /// A set of time events. You can have up to 32 annotations and 128 message
    /// events per span.
    pub time_events: std::option::Option<crate::model::span::TimeEvents>,

    /// Links associated with the span. You can have up to 128 links per Span.
    pub links: std::option::Option<crate::model::span::Links>,

    /// Optional. The final status for this span.
    pub status: std::option::Option<google_cloud_rpc::model::Status>,

    /// Optional. Set this parameter to indicate whether this span is in
    /// the same process as its parent. If you do not set this parameter,
    /// Trace is unable to take advantage of this helpful information.
    pub same_process_as_parent_span: std::option::Option<wkt::BoolValue>,

    /// Optional. The number of child spans that were generated while this span
    /// was active. If set, allows implementation to detect missing child spans.
    pub child_span_count: std::option::Option<wkt::Int32Value>,

    /// Optional. Distinguishes between spans generated in a particular context.
    /// For example, two spans with the same name may be distinguished using
    /// `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.
    pub span_kind: crate::model::span::SpanKind,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Span {
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Span::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// let x = Span::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [span_id][crate::model::Span::span_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// let x = Span::new().set_span_id("example");
    /// ```
    pub fn set_span_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.span_id = v.into();
        self
    }

    /// Sets the value of [parent_span_id][crate::model::Span::parent_span_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// let x = Span::new().set_parent_span_id("example");
    /// ```
    pub fn set_parent_span_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent_span_id = v.into();
        self
    }

    /// Sets the value of [display_name][crate::model::Span::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::TruncatableString;
    /// let x = Span::new().set_display_name(TruncatableString::default()/* use setters */);
    /// ```
    pub fn set_display_name<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TruncatableString>,
    {
        self.display_name = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [display_name][crate::model::Span::display_name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::TruncatableString;
    /// let x = Span::new().set_or_clear_display_name(Some(TruncatableString::default()/* use setters */));
    /// let x = Span::new().set_or_clear_display_name(None::<TruncatableString>);
    /// ```
    pub fn set_or_clear_display_name<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TruncatableString>,
    {
        self.display_name = v.map(|x| x.into());
        self
    }

    /// Sets the value of [start_time][crate::model::Span::start_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use wkt::Timestamp;
    /// let x = Span::new().set_start_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_start_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.start_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [start_time][crate::model::Span::start_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use wkt::Timestamp;
    /// let x = Span::new().set_or_clear_start_time(Some(Timestamp::default()/* use setters */));
    /// let x = Span::new().set_or_clear_start_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_start_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.start_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [end_time][crate::model::Span::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use wkt::Timestamp;
    /// let x = Span::new().set_end_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_end_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [end_time][crate::model::Span::end_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use wkt::Timestamp;
    /// let x = Span::new().set_or_clear_end_time(Some(Timestamp::default()/* use setters */));
    /// let x = Span::new().set_or_clear_end_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_end_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.end_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [attributes][crate::model::Span::attributes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::span::Attributes;
    /// let x = Span::new().set_attributes(Attributes::default()/* use setters */);
    /// ```
    pub fn set_attributes<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::span::Attributes>,
    {
        self.attributes = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [attributes][crate::model::Span::attributes].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::span::Attributes;
    /// let x = Span::new().set_or_clear_attributes(Some(Attributes::default()/* use setters */));
    /// let x = Span::new().set_or_clear_attributes(None::<Attributes>);
    /// ```
    pub fn set_or_clear_attributes<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::span::Attributes>,
    {
        self.attributes = v.map(|x| x.into());
        self
    }

    /// Sets the value of [stack_trace][crate::model::Span::stack_trace].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::StackTrace;
    /// let x = Span::new().set_stack_trace(StackTrace::default()/* use setters */);
    /// ```
    pub fn set_stack_trace<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::StackTrace>,
    {
        self.stack_trace = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [stack_trace][crate::model::Span::stack_trace].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::StackTrace;
    /// let x = Span::new().set_or_clear_stack_trace(Some(StackTrace::default()/* use setters */));
    /// let x = Span::new().set_or_clear_stack_trace(None::<StackTrace>);
    /// ```
    pub fn set_or_clear_stack_trace<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::StackTrace>,
    {
        self.stack_trace = v.map(|x| x.into());
        self
    }

    /// Sets the value of [time_events][crate::model::Span::time_events].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::span::TimeEvents;
    /// let x = Span::new().set_time_events(TimeEvents::default()/* use setters */);
    /// ```
    pub fn set_time_events<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::span::TimeEvents>,
    {
        self.time_events = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [time_events][crate::model::Span::time_events].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::span::TimeEvents;
    /// let x = Span::new().set_or_clear_time_events(Some(TimeEvents::default()/* use setters */));
    /// let x = Span::new().set_or_clear_time_events(None::<TimeEvents>);
    /// ```
    pub fn set_or_clear_time_events<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::span::TimeEvents>,
    {
        self.time_events = v.map(|x| x.into());
        self
    }

    /// Sets the value of [links][crate::model::Span::links].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::span::Links;
    /// let x = Span::new().set_links(Links::default()/* use setters */);
    /// ```
    pub fn set_links<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::span::Links>,
    {
        self.links = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [links][crate::model::Span::links].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::span::Links;
    /// let x = Span::new().set_or_clear_links(Some(Links::default()/* use setters */));
    /// let x = Span::new().set_or_clear_links(None::<Links>);
    /// ```
    pub fn set_or_clear_links<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::span::Links>,
    {
        self.links = v.map(|x| x.into());
        self
    }

    /// Sets the value of [status][crate::model::Span::status].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_rpc::model::Status;
    /// let x = Span::new().set_status(Status::default()/* use setters */);
    /// ```
    pub fn set_status<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<google_cloud_rpc::model::Status>,
    {
        self.status = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [status][crate::model::Span::status].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_rpc::model::Status;
    /// let x = Span::new().set_or_clear_status(Some(Status::default()/* use setters */));
    /// let x = Span::new().set_or_clear_status(None::<Status>);
    /// ```
    pub fn set_or_clear_status<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<google_cloud_rpc::model::Status>,
    {
        self.status = v.map(|x| x.into());
        self
    }

    /// Sets the value of [same_process_as_parent_span][crate::model::Span::same_process_as_parent_span].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use wkt::BoolValue;
    /// let x = Span::new().set_same_process_as_parent_span(BoolValue::default()/* use setters */);
    /// ```
    pub fn set_same_process_as_parent_span<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::BoolValue>,
    {
        self.same_process_as_parent_span = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [same_process_as_parent_span][crate::model::Span::same_process_as_parent_span].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use wkt::BoolValue;
    /// let x = Span::new().set_or_clear_same_process_as_parent_span(Some(BoolValue::default()/* use setters */));
    /// let x = Span::new().set_or_clear_same_process_as_parent_span(None::<BoolValue>);
    /// ```
    pub fn set_or_clear_same_process_as_parent_span<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::BoolValue>,
    {
        self.same_process_as_parent_span = v.map(|x| x.into());
        self
    }

    /// Sets the value of [child_span_count][crate::model::Span::child_span_count].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use wkt::Int32Value;
    /// let x = Span::new().set_child_span_count(Int32Value::default()/* use setters */);
    /// ```
    pub fn set_child_span_count<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Int32Value>,
    {
        self.child_span_count = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [child_span_count][crate::model::Span::child_span_count].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use wkt::Int32Value;
    /// let x = Span::new().set_or_clear_child_span_count(Some(Int32Value::default()/* use setters */));
    /// let x = Span::new().set_or_clear_child_span_count(None::<Int32Value>);
    /// ```
    pub fn set_or_clear_child_span_count<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Int32Value>,
    {
        self.child_span_count = v.map(|x| x.into());
        self
    }

    /// Sets the value of [span_kind][crate::model::Span::span_kind].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Span;
    /// use google_cloud_trace_v2::model::span::SpanKind;
    /// let x0 = Span::new().set_span_kind(SpanKind::Internal);
    /// let x1 = Span::new().set_span_kind(SpanKind::Server);
    /// let x2 = Span::new().set_span_kind(SpanKind::Client);
    /// ```
    pub fn set_span_kind<T: std::convert::Into<crate::model::span::SpanKind>>(
        mut self,
        v: T,
    ) -> Self {
        self.span_kind = v.into();
        self
    }
}

impl wkt::message::Message for Span {
    fn typename() -> &'static str {
        "type.googleapis.com/google.devtools.cloudtrace.v2.Span"
    }
}

/// Defines additional types related to [Span].
pub mod span {
    #[allow(unused_imports)]
    use super::*;

    /// A set of attributes as key-value pairs.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct Attributes {
        /// A set of attributes. Each attribute's key can be up to 128 bytes
        /// long. The value can be a string up to 256 bytes, a signed 64-bit integer,
        /// or the boolean values `true` or `false`. For example:
        ///
        /// ```norust
        /// "/instance_id": { "string_value": { "value": "my-instance" } }
        /// "/http/request_bytes": { "int_value": 300 }
        /// "abc.com/myattribute": { "bool_value": false }
        /// ```
        pub attribute_map:
            std::collections::HashMap<std::string::String, crate::model::AttributeValue>,

        /// The number of attributes that were discarded. Attributes can be discarded
        /// because their keys are too long or because there are too many attributes.
        /// If this value is 0 then all attributes are valid.
        pub dropped_attributes_count: i32,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl Attributes {
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [attribute_map][crate::model::span::Attributes::attribute_map].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::Attributes;
        /// use google_cloud_trace_v2::model::AttributeValue;
        /// let x = Attributes::new().set_attribute_map([
        ///     ("key0", AttributeValue::default()/* use setters */),
        ///     ("key1", AttributeValue::default()/* use (different) setters */),
        /// ]);
        /// ```
        pub fn set_attribute_map<T, K, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = (K, V)>,
            K: std::convert::Into<std::string::String>,
            V: std::convert::Into<crate::model::AttributeValue>,
        {
            use std::iter::Iterator;
            self.attribute_map = v.into_iter().map(|(k, v)| (k.into(), v.into())).collect();
            self
        }

        /// Sets the value of [dropped_attributes_count][crate::model::span::Attributes::dropped_attributes_count].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::Attributes;
        /// let x = Attributes::new().set_dropped_attributes_count(42);
        /// ```
        pub fn set_dropped_attributes_count<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
            self.dropped_attributes_count = v.into();
            self
        }
    }

    impl wkt::message::Message for Attributes {
        fn typename() -> &'static str {
            "type.googleapis.com/google.devtools.cloudtrace.v2.Span.Attributes"
        }
    }

    /// A time-stamped annotation or message event in the Span.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct TimeEvent {
        /// The timestamp indicating the time the event occurred.
        pub time: std::option::Option<wkt::Timestamp>,

        /// A `TimeEvent` can contain either an `Annotation` object or a
        /// `MessageEvent` object, but not both.
        pub value: std::option::Option<crate::model::span::time_event::Value>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl TimeEvent {
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [time][crate::model::span::TimeEvent::time].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::TimeEvent;
        /// use wkt::Timestamp;
        /// let x = TimeEvent::new().set_time(Timestamp::default()/* use setters */);
        /// ```
        pub fn set_time<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<wkt::Timestamp>,
        {
            self.time = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [time][crate::model::span::TimeEvent::time].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::TimeEvent;
        /// use wkt::Timestamp;
        /// let x = TimeEvent::new().set_or_clear_time(Some(Timestamp::default()/* use setters */));
        /// let x = TimeEvent::new().set_or_clear_time(None::<Timestamp>);
        /// ```
        pub fn set_or_clear_time<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<wkt::Timestamp>,
        {
            self.time = v.map(|x| x.into());
            self
        }

        /// Sets the value of [value][crate::model::span::TimeEvent::value].
        ///
        /// Note that all the setters affecting `value` are mutually
        /// exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::TimeEvent;
        /// use google_cloud_trace_v2::model::span::time_event::Annotation;
        /// let x = TimeEvent::new().set_value(Some(
        ///     google_cloud_trace_v2::model::span::time_event::Value::Annotation(Annotation::default().into())));
        /// ```
        pub fn set_value<
            T: std::convert::Into<std::option::Option<crate::model::span::time_event::Value>>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.value = v.into();
            self
        }

        /// The value of [value][crate::model::span::TimeEvent::value]
        /// if it holds a `Annotation`, `None` if the field is not set or
        /// holds a different branch.
        pub fn annotation(
            &self,
        ) -> std::option::Option<&std::boxed::Box<crate::model::span::time_event::Annotation>>
        {
            #[allow(unreachable_patterns)]
            self.value.as_ref().and_then(|v| match v {
                crate::model::span::time_event::Value::Annotation(v) => {
                    std::option::Option::Some(v)
                }
                _ => std::option::Option::None,
            })
        }

        /// Sets the value of [value][crate::model::span::TimeEvent::value]
        /// to hold a `Annotation`.
        ///
        /// Note that all the setters affecting `value` are
        /// mutually exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::TimeEvent;
        /// use google_cloud_trace_v2::model::span::time_event::Annotation;
        /// let x = TimeEvent::new().set_annotation(Annotation::default()/* use setters */);
        /// assert!(x.annotation().is_some());
        /// assert!(x.message_event().is_none());
        /// ```
        pub fn set_annotation<
            T: std::convert::Into<std::boxed::Box<crate::model::span::time_event::Annotation>>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.value = std::option::Option::Some(
                crate::model::span::time_event::Value::Annotation(v.into()),
            );
            self
        }

        /// The value of [value][crate::model::span::TimeEvent::value]
        /// if it holds a `MessageEvent`, `None` if the field is not set or
        /// holds a different branch.
        pub fn message_event(
            &self,
        ) -> std::option::Option<&std::boxed::Box<crate::model::span::time_event::MessageEvent>>
        {
            #[allow(unreachable_patterns)]
            self.value.as_ref().and_then(|v| match v {
                crate::model::span::time_event::Value::MessageEvent(v) => {
                    std::option::Option::Some(v)
                }
                _ => std::option::Option::None,
            })
        }

        /// Sets the value of [value][crate::model::span::TimeEvent::value]
        /// to hold a `MessageEvent`.
        ///
        /// Note that all the setters affecting `value` are
        /// mutually exclusive.
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::TimeEvent;
        /// use google_cloud_trace_v2::model::span::time_event::MessageEvent;
        /// let x = TimeEvent::new().set_message_event(MessageEvent::default()/* use setters */);
        /// assert!(x.message_event().is_some());
        /// assert!(x.annotation().is_none());
        /// ```
        pub fn set_message_event<
            T: std::convert::Into<std::boxed::Box<crate::model::span::time_event::MessageEvent>>,
        >(
            mut self,
            v: T,
        ) -> Self {
            self.value = std::option::Option::Some(
                crate::model::span::time_event::Value::MessageEvent(v.into()),
            );
            self
        }
    }

    impl wkt::message::Message for TimeEvent {
        fn typename() -> &'static str {
            "type.googleapis.com/google.devtools.cloudtrace.v2.Span.TimeEvent"
        }
    }

    /// Defines additional types related to [TimeEvent].
    pub mod time_event {
        #[allow(unused_imports)]
        use super::*;

        /// Text annotation with a set of attributes.
        #[derive(Clone, Default, PartialEq)]
        #[non_exhaustive]
        pub struct Annotation {
            /// A user-supplied message describing the event. The maximum length for
            /// the description is 256 bytes.
            pub description: std::option::Option<crate::model::TruncatableString>,

            /// A set of attributes on the annotation. You can have up to 4 attributes
            /// per Annotation.
            pub attributes: std::option::Option<crate::model::span::Attributes>,

            pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
        }

        impl Annotation {
            pub fn new() -> Self {
                std::default::Default::default()
            }

            /// Sets the value of [description][crate::model::span::time_event::Annotation::description].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_trace_v2::model::span::time_event::Annotation;
            /// use google_cloud_trace_v2::model::TruncatableString;
            /// let x = Annotation::new().set_description(TruncatableString::default()/* use setters */);
            /// ```
            pub fn set_description<T>(mut self, v: T) -> Self
            where
                T: std::convert::Into<crate::model::TruncatableString>,
            {
                self.description = std::option::Option::Some(v.into());
                self
            }

            /// Sets or clears the value of [description][crate::model::span::time_event::Annotation::description].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_trace_v2::model::span::time_event::Annotation;
            /// use google_cloud_trace_v2::model::TruncatableString;
            /// let x = Annotation::new().set_or_clear_description(Some(TruncatableString::default()/* use setters */));
            /// let x = Annotation::new().set_or_clear_description(None::<TruncatableString>);
            /// ```
            pub fn set_or_clear_description<T>(mut self, v: std::option::Option<T>) -> Self
            where
                T: std::convert::Into<crate::model::TruncatableString>,
            {
                self.description = v.map(|x| x.into());
                self
            }

            /// Sets the value of [attributes][crate::model::span::time_event::Annotation::attributes].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_trace_v2::model::span::time_event::Annotation;
            /// use google_cloud_trace_v2::model::span::Attributes;
            /// let x = Annotation::new().set_attributes(Attributes::default()/* use setters */);
            /// ```
            pub fn set_attributes<T>(mut self, v: T) -> Self
            where
                T: std::convert::Into<crate::model::span::Attributes>,
            {
                self.attributes = std::option::Option::Some(v.into());
                self
            }

            /// Sets or clears the value of [attributes][crate::model::span::time_event::Annotation::attributes].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_trace_v2::model::span::time_event::Annotation;
            /// use google_cloud_trace_v2::model::span::Attributes;
            /// let x = Annotation::new().set_or_clear_attributes(Some(Attributes::default()/* use setters */));
            /// let x = Annotation::new().set_or_clear_attributes(None::<Attributes>);
            /// ```
            pub fn set_or_clear_attributes<T>(mut self, v: std::option::Option<T>) -> Self
            where
                T: std::convert::Into<crate::model::span::Attributes>,
            {
                self.attributes = v.map(|x| x.into());
                self
            }
        }

        impl wkt::message::Message for Annotation {
            fn typename() -> &'static str {
                "type.googleapis.com/google.devtools.cloudtrace.v2.Span.TimeEvent.Annotation"
            }
        }

        /// An event describing a message sent/received between Spans.
        #[derive(Clone, Default, PartialEq)]
        #[non_exhaustive]
        pub struct MessageEvent {
            /// Type of MessageEvent. Indicates whether the message was sent or
            /// received.
            pub r#type: crate::model::span::time_event::message_event::Type,

            /// An identifier for the MessageEvent's message that can be used to match
            /// `SENT` and `RECEIVED` MessageEvents.
            pub id: i64,

            /// The number of uncompressed bytes sent or received.
            pub uncompressed_size_bytes: i64,

            /// The number of compressed bytes sent or received. If missing, the
            /// compressed size is assumed to be the same size as the uncompressed
            /// size.
            pub compressed_size_bytes: i64,

            pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
        }

        impl MessageEvent {
            pub fn new() -> Self {
                std::default::Default::default()
            }

            /// Sets the value of [r#type][crate::model::span::time_event::MessageEvent::type].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_trace_v2::model::span::time_event::MessageEvent;
            /// use google_cloud_trace_v2::model::span::time_event::message_event::Type;
            /// let x0 = MessageEvent::new().set_type(Type::Sent);
            /// let x1 = MessageEvent::new().set_type(Type::Received);
            /// ```
            pub fn set_type<
                T: std::convert::Into<crate::model::span::time_event::message_event::Type>,
            >(
                mut self,
                v: T,
            ) -> Self {
                self.r#type = v.into();
                self
            }

            /// Sets the value of [id][crate::model::span::time_event::MessageEvent::id].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_trace_v2::model::span::time_event::MessageEvent;
            /// let x = MessageEvent::new().set_id(42);
            /// ```
            pub fn set_id<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
                self.id = v.into();
                self
            }

            /// Sets the value of [uncompressed_size_bytes][crate::model::span::time_event::MessageEvent::uncompressed_size_bytes].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_trace_v2::model::span::time_event::MessageEvent;
            /// let x = MessageEvent::new().set_uncompressed_size_bytes(42);
            /// ```
            pub fn set_uncompressed_size_bytes<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
                self.uncompressed_size_bytes = v.into();
                self
            }

            /// Sets the value of [compressed_size_bytes][crate::model::span::time_event::MessageEvent::compressed_size_bytes].
            ///
            /// # Example
            /// ```ignore,no_run
            /// # use google_cloud_trace_v2::model::span::time_event::MessageEvent;
            /// let x = MessageEvent::new().set_compressed_size_bytes(42);
            /// ```
            pub fn set_compressed_size_bytes<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
                self.compressed_size_bytes = v.into();
                self
            }
        }

        impl wkt::message::Message for MessageEvent {
            fn typename() -> &'static str {
                "type.googleapis.com/google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent"
            }
        }

        /// Defines additional types related to [MessageEvent].
        pub mod message_event {
            #[allow(unused_imports)]
            use super::*;

            /// Indicates whether the message was sent or received.
            ///
            /// # Working with unknown values
            ///
            /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
            /// additional enum variants at any time. Adding new variants is not considered
            /// a breaking change. Applications should write their code in anticipation of:
            ///
            /// - New values appearing in future releases of the client library, **and**
            /// - New values received dynamically, without application changes.
            ///
            /// Please consult the [Working with enums] section in the user guide for some
            /// guidelines.
            ///
            /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
            #[derive(Clone, Debug, PartialEq)]
            #[non_exhaustive]
            pub enum Type {
                /// Unknown event type.
                Unspecified,
                /// Indicates a sent message.
                Sent,
                /// Indicates a received message.
                Received,
                /// If set, the enum was initialized with an unknown value.
                ///
                /// Applications can examine the value using [Type::value] or
                /// [Type::name].
                UnknownValue(r#type::UnknownValue),
            }

            #[doc(hidden)]
            pub mod r#type {
                #[allow(unused_imports)]
                use super::*;
                #[derive(Clone, Debug, PartialEq)]
                pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
            }

            impl Type {
                /// Gets the enum value.
                ///
                /// Returns `None` if the enum contains an unknown value deserialized from
                /// the string representation of enums.
                pub fn value(&self) -> std::option::Option<i32> {
                    match self {
                        Self::Unspecified => std::option::Option::Some(0),
                        Self::Sent => std::option::Option::Some(1),
                        Self::Received => std::option::Option::Some(2),
                        Self::UnknownValue(u) => u.0.value(),
                    }
                }

                /// Gets the enum value as a string.
                ///
                /// Returns `None` if the enum contains an unknown value deserialized from
                /// the integer representation of enums.
                pub fn name(&self) -> std::option::Option<&str> {
                    match self {
                        Self::Unspecified => std::option::Option::Some("TYPE_UNSPECIFIED"),
                        Self::Sent => std::option::Option::Some("SENT"),
                        Self::Received => std::option::Option::Some("RECEIVED"),
                        Self::UnknownValue(u) => u.0.name(),
                    }
                }
            }

            impl std::default::Default for Type {
                fn default() -> Self {
                    use std::convert::From;
                    Self::from(0)
                }
            }

            impl std::fmt::Display for Type {
                fn fmt(
                    &self,
                    f: &mut std::fmt::Formatter<'_>,
                ) -> std::result::Result<(), std::fmt::Error> {
                    wkt::internal::display_enum(f, self.name(), self.value())
                }
            }

            impl std::convert::From<i32> for Type {
                fn from(value: i32) -> Self {
                    match value {
                        0 => Self::Unspecified,
                        1 => Self::Sent,
                        2 => Self::Received,
                        _ => Self::UnknownValue(r#type::UnknownValue(
                            wkt::internal::UnknownEnumValue::Integer(value),
                        )),
                    }
                }
            }

            impl std::convert::From<&str> for Type {
                fn from(value: &str) -> Self {
                    use std::string::ToString;
                    match value {
                        "TYPE_UNSPECIFIED" => Self::Unspecified,
                        "SENT" => Self::Sent,
                        "RECEIVED" => Self::Received,
                        _ => Self::UnknownValue(r#type::UnknownValue(
                            wkt::internal::UnknownEnumValue::String(value.to_string()),
                        )),
                    }
                }
            }

            impl serde::ser::Serialize for Type {
                fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
                where
                    S: serde::Serializer,
                {
                    match self {
                        Self::Unspecified => serializer.serialize_i32(0),
                        Self::Sent => serializer.serialize_i32(1),
                        Self::Received => serializer.serialize_i32(2),
                        Self::UnknownValue(u) => u.0.serialize(serializer),
                    }
                }
            }

            impl<'de> serde::de::Deserialize<'de> for Type {
                fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
                where
                    D: serde::Deserializer<'de>,
                {
                    deserializer.deserialize_any(wkt::internal::EnumVisitor::<Type>::new(
                        ".google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent.Type",
                    ))
                }
            }
        }

        /// A `TimeEvent` can contain either an `Annotation` object or a
        /// `MessageEvent` object, but not both.
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum Value {
            /// Text annotation with a set of attributes.
            Annotation(std::boxed::Box<crate::model::span::time_event::Annotation>),
            /// An event describing a message sent/received between Spans.
            MessageEvent(std::boxed::Box<crate::model::span::time_event::MessageEvent>),
        }
    }

    /// A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation
    /// on the span, consisting of either user-supplied key:value pairs, or
    /// details of a message sent/received between Spans.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct TimeEvents {
        /// A collection of `TimeEvent`s.
        pub time_event: std::vec::Vec<crate::model::span::TimeEvent>,

        /// The number of dropped annotations in all the included time events.
        /// If the value is 0, then no annotations were dropped.
        pub dropped_annotations_count: i32,

        /// The number of dropped message events in all the included time events.
        /// If the value is 0, then no message events were dropped.
        pub dropped_message_events_count: i32,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl TimeEvents {
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [time_event][crate::model::span::TimeEvents::time_event].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::TimeEvents;
        /// use google_cloud_trace_v2::model::span::TimeEvent;
        /// let x = TimeEvents::new()
        ///     .set_time_event([
        ///         TimeEvent::default()/* use setters */,
        ///         TimeEvent::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_time_event<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::span::TimeEvent>,
        {
            use std::iter::Iterator;
            self.time_event = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [dropped_annotations_count][crate::model::span::TimeEvents::dropped_annotations_count].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::TimeEvents;
        /// let x = TimeEvents::new().set_dropped_annotations_count(42);
        /// ```
        pub fn set_dropped_annotations_count<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
            self.dropped_annotations_count = v.into();
            self
        }

        /// Sets the value of [dropped_message_events_count][crate::model::span::TimeEvents::dropped_message_events_count].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::TimeEvents;
        /// let x = TimeEvents::new().set_dropped_message_events_count(42);
        /// ```
        pub fn set_dropped_message_events_count<T: std::convert::Into<i32>>(
            mut self,
            v: T,
        ) -> Self {
            self.dropped_message_events_count = v.into();
            self
        }
    }

    impl wkt::message::Message for TimeEvents {
        fn typename() -> &'static str {
            "type.googleapis.com/google.devtools.cloudtrace.v2.Span.TimeEvents"
        }
    }

    /// A pointer from the current span to another span in the same trace or in a
    /// different trace. For example, this can be used in batching operations,
    /// where a single batch handler processes multiple requests from different
    /// traces or when the handler receives a request from a different project.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct Link {
        /// The `[TRACE_ID]` for a trace within a project.
        pub trace_id: std::string::String,

        /// The `[SPAN_ID]` for a span within a trace.
        pub span_id: std::string::String,

        /// The relationship of the current span relative to the linked span.
        pub r#type: crate::model::span::link::Type,

        /// A set of attributes on the link. Up to 32 attributes can be
        /// specified per link.
        pub attributes: std::option::Option<crate::model::span::Attributes>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl Link {
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [trace_id][crate::model::span::Link::trace_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::Link;
        /// let x = Link::new().set_trace_id("example");
        /// ```
        pub fn set_trace_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.trace_id = v.into();
            self
        }

        /// Sets the value of [span_id][crate::model::span::Link::span_id].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::Link;
        /// let x = Link::new().set_span_id("example");
        /// ```
        pub fn set_span_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
            self.span_id = v.into();
            self
        }

        /// Sets the value of [r#type][crate::model::span::Link::type].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::Link;
        /// use google_cloud_trace_v2::model::span::link::Type;
        /// let x0 = Link::new().set_type(Type::ChildLinkedSpan);
        /// let x1 = Link::new().set_type(Type::ParentLinkedSpan);
        /// ```
        pub fn set_type<T: std::convert::Into<crate::model::span::link::Type>>(
            mut self,
            v: T,
        ) -> Self {
            self.r#type = v.into();
            self
        }

        /// Sets the value of [attributes][crate::model::span::Link::attributes].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::Link;
        /// use google_cloud_trace_v2::model::span::Attributes;
        /// let x = Link::new().set_attributes(Attributes::default()/* use setters */);
        /// ```
        pub fn set_attributes<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::span::Attributes>,
        {
            self.attributes = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [attributes][crate::model::span::Link::attributes].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::Link;
        /// use google_cloud_trace_v2::model::span::Attributes;
        /// let x = Link::new().set_or_clear_attributes(Some(Attributes::default()/* use setters */));
        /// let x = Link::new().set_or_clear_attributes(None::<Attributes>);
        /// ```
        pub fn set_or_clear_attributes<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::span::Attributes>,
        {
            self.attributes = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for Link {
        fn typename() -> &'static str {
            "type.googleapis.com/google.devtools.cloudtrace.v2.Span.Link"
        }
    }

    /// Defines additional types related to [Link].
    pub mod link {
        #[allow(unused_imports)]
        use super::*;

        /// The relationship of the current span relative to the linked span: child,
        /// parent, or unspecified.
        ///
        /// # Working with unknown values
        ///
        /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
        /// additional enum variants at any time. Adding new variants is not considered
        /// a breaking change. Applications should write their code in anticipation of:
        ///
        /// - New values appearing in future releases of the client library, **and**
        /// - New values received dynamically, without application changes.
        ///
        /// Please consult the [Working with enums] section in the user guide for some
        /// guidelines.
        ///
        /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
        #[derive(Clone, Debug, PartialEq)]
        #[non_exhaustive]
        pub enum Type {
            /// The relationship of the two spans is unknown.
            Unspecified,
            /// The linked span is a child of the current span.
            ChildLinkedSpan,
            /// The linked span is a parent of the current span.
            ParentLinkedSpan,
            /// If set, the enum was initialized with an unknown value.
            ///
            /// Applications can examine the value using [Type::value] or
            /// [Type::name].
            UnknownValue(r#type::UnknownValue),
        }

        #[doc(hidden)]
        pub mod r#type {
            #[allow(unused_imports)]
            use super::*;
            #[derive(Clone, Debug, PartialEq)]
            pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
        }

        impl Type {
            /// Gets the enum value.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the string representation of enums.
            pub fn value(&self) -> std::option::Option<i32> {
                match self {
                    Self::Unspecified => std::option::Option::Some(0),
                    Self::ChildLinkedSpan => std::option::Option::Some(1),
                    Self::ParentLinkedSpan => std::option::Option::Some(2),
                    Self::UnknownValue(u) => u.0.value(),
                }
            }

            /// Gets the enum value as a string.
            ///
            /// Returns `None` if the enum contains an unknown value deserialized from
            /// the integer representation of enums.
            pub fn name(&self) -> std::option::Option<&str> {
                match self {
                    Self::Unspecified => std::option::Option::Some("TYPE_UNSPECIFIED"),
                    Self::ChildLinkedSpan => std::option::Option::Some("CHILD_LINKED_SPAN"),
                    Self::ParentLinkedSpan => std::option::Option::Some("PARENT_LINKED_SPAN"),
                    Self::UnknownValue(u) => u.0.name(),
                }
            }
        }

        impl std::default::Default for Type {
            fn default() -> Self {
                use std::convert::From;
                Self::from(0)
            }
        }

        impl std::fmt::Display for Type {
            fn fmt(
                &self,
                f: &mut std::fmt::Formatter<'_>,
            ) -> std::result::Result<(), std::fmt::Error> {
                wkt::internal::display_enum(f, self.name(), self.value())
            }
        }

        impl std::convert::From<i32> for Type {
            fn from(value: i32) -> Self {
                match value {
                    0 => Self::Unspecified,
                    1 => Self::ChildLinkedSpan,
                    2 => Self::ParentLinkedSpan,
                    _ => Self::UnknownValue(r#type::UnknownValue(
                        wkt::internal::UnknownEnumValue::Integer(value),
                    )),
                }
            }
        }

        impl std::convert::From<&str> for Type {
            fn from(value: &str) -> Self {
                use std::string::ToString;
                match value {
                    "TYPE_UNSPECIFIED" => Self::Unspecified,
                    "CHILD_LINKED_SPAN" => Self::ChildLinkedSpan,
                    "PARENT_LINKED_SPAN" => Self::ParentLinkedSpan,
                    _ => Self::UnknownValue(r#type::UnknownValue(
                        wkt::internal::UnknownEnumValue::String(value.to_string()),
                    )),
                }
            }
        }

        impl serde::ser::Serialize for Type {
            fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
            where
                S: serde::Serializer,
            {
                match self {
                    Self::Unspecified => serializer.serialize_i32(0),
                    Self::ChildLinkedSpan => serializer.serialize_i32(1),
                    Self::ParentLinkedSpan => serializer.serialize_i32(2),
                    Self::UnknownValue(u) => u.0.serialize(serializer),
                }
            }
        }

        impl<'de> serde::de::Deserialize<'de> for Type {
            fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
            where
                D: serde::Deserializer<'de>,
            {
                deserializer.deserialize_any(wkt::internal::EnumVisitor::<Type>::new(
                    ".google.devtools.cloudtrace.v2.Span.Link.Type",
                ))
            }
        }
    }

    /// A collection of links, which are references from this span to a span
    /// in the same or different trace.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct Links {
        /// A collection of links.
        pub link: std::vec::Vec<crate::model::span::Link>,

        /// The number of dropped links after the maximum size was enforced. If
        /// this value is 0, then no links were dropped.
        pub dropped_links_count: i32,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl Links {
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [link][crate::model::span::Links::link].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::Links;
        /// use google_cloud_trace_v2::model::span::Link;
        /// let x = Links::new()
        ///     .set_link([
        ///         Link::default()/* use setters */,
        ///         Link::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_link<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::span::Link>,
        {
            use std::iter::Iterator;
            self.link = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [dropped_links_count][crate::model::span::Links::dropped_links_count].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::span::Links;
        /// let x = Links::new().set_dropped_links_count(42);
        /// ```
        pub fn set_dropped_links_count<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
            self.dropped_links_count = v.into();
            self
        }
    }

    impl wkt::message::Message for Links {
        fn typename() -> &'static str {
            "type.googleapis.com/google.devtools.cloudtrace.v2.Span.Links"
        }
    }

    /// Type of span. Can be used to specify additional relationships between spans
    /// in addition to a parent/child relationship.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum SpanKind {
        /// Unspecified. Do NOT use as default.
        /// Implementations MAY assume SpanKind.INTERNAL to be default.
        Unspecified,
        /// Indicates that the span is used internally. Default value.
        Internal,
        /// Indicates that the span covers server-side handling of an RPC or other
        /// remote network request.
        Server,
        /// Indicates that the span covers the client-side wrapper around an RPC or
        /// other remote request.
        Client,
        /// Indicates that the span describes producer sending a message to a broker.
        /// Unlike client and  server, there is no direct critical path latency
        /// relationship between producer and consumer spans (e.g. publishing a
        /// message to a pubsub service).
        Producer,
        /// Indicates that the span describes consumer receiving a message from a
        /// broker. Unlike client and  server, there is no direct critical path
        /// latency relationship between producer and consumer spans (e.g. receiving
        /// a message from a pubsub service subscription).
        Consumer,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [SpanKind::value] or
        /// [SpanKind::name].
        UnknownValue(span_kind::UnknownValue),
    }

    #[doc(hidden)]
    pub mod span_kind {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl SpanKind {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::Internal => std::option::Option::Some(1),
                Self::Server => std::option::Option::Some(2),
                Self::Client => std::option::Option::Some(3),
                Self::Producer => std::option::Option::Some(4),
                Self::Consumer => std::option::Option::Some(5),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("SPAN_KIND_UNSPECIFIED"),
                Self::Internal => std::option::Option::Some("INTERNAL"),
                Self::Server => std::option::Option::Some("SERVER"),
                Self::Client => std::option::Option::Some("CLIENT"),
                Self::Producer => std::option::Option::Some("PRODUCER"),
                Self::Consumer => std::option::Option::Some("CONSUMER"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for SpanKind {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for SpanKind {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for SpanKind {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::Internal,
                2 => Self::Server,
                3 => Self::Client,
                4 => Self::Producer,
                5 => Self::Consumer,
                _ => Self::UnknownValue(span_kind::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for SpanKind {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "SPAN_KIND_UNSPECIFIED" => Self::Unspecified,
                "INTERNAL" => Self::Internal,
                "SERVER" => Self::Server,
                "CLIENT" => Self::Client,
                "PRODUCER" => Self::Producer,
                "CONSUMER" => Self::Consumer,
                _ => Self::UnknownValue(span_kind::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for SpanKind {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::Internal => serializer.serialize_i32(1),
                Self::Server => serializer.serialize_i32(2),
                Self::Client => serializer.serialize_i32(3),
                Self::Producer => serializer.serialize_i32(4),
                Self::Consumer => serializer.serialize_i32(5),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for SpanKind {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<SpanKind>::new(
                ".google.devtools.cloudtrace.v2.Span.SpanKind",
            ))
        }
    }
}

/// The allowed types for `[VALUE]` in a `[KEY]:[VALUE]` attribute.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AttributeValue {
    /// The type of the value.
    pub value: std::option::Option<crate::model::attribute_value::Value>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AttributeValue {
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [value][crate::model::AttributeValue::value].
    ///
    /// Note that all the setters affecting `value` are mutually
    /// exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::AttributeValue;
    /// use google_cloud_trace_v2::model::attribute_value::Value;
    /// let x = AttributeValue::new().set_value(Some(Value::IntValue(42)));
    /// ```
    pub fn set_value<
        T: std::convert::Into<std::option::Option<crate::model::attribute_value::Value>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.value = v.into();
        self
    }

    /// The value of [value][crate::model::AttributeValue::value]
    /// if it holds a `StringValue`, `None` if the field is not set or
    /// holds a different branch.
    pub fn string_value(
        &self,
    ) -> std::option::Option<&std::boxed::Box<crate::model::TruncatableString>> {
        #[allow(unreachable_patterns)]
        self.value.as_ref().and_then(|v| match v {
            crate::model::attribute_value::Value::StringValue(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [value][crate::model::AttributeValue::value]
    /// to hold a `StringValue`.
    ///
    /// Note that all the setters affecting `value` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::AttributeValue;
    /// use google_cloud_trace_v2::model::TruncatableString;
    /// let x = AttributeValue::new().set_string_value(TruncatableString::default()/* use setters */);
    /// assert!(x.string_value().is_some());
    /// assert!(x.int_value().is_none());
    /// assert!(x.bool_value().is_none());
    /// ```
    pub fn set_string_value<
        T: std::convert::Into<std::boxed::Box<crate::model::TruncatableString>>,
    >(
        mut self,
        v: T,
    ) -> Self {
        self.value =
            std::option::Option::Some(crate::model::attribute_value::Value::StringValue(v.into()));
        self
    }

    /// The value of [value][crate::model::AttributeValue::value]
    /// if it holds a `IntValue`, `None` if the field is not set or
    /// holds a different branch.
    pub fn int_value(&self) -> std::option::Option<&i64> {
        #[allow(unreachable_patterns)]
        self.value.as_ref().and_then(|v| match v {
            crate::model::attribute_value::Value::IntValue(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [value][crate::model::AttributeValue::value]
    /// to hold a `IntValue`.
    ///
    /// Note that all the setters affecting `value` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::AttributeValue;
    /// let x = AttributeValue::new().set_int_value(42);
    /// assert!(x.int_value().is_some());
    /// assert!(x.string_value().is_none());
    /// assert!(x.bool_value().is_none());
    /// ```
    pub fn set_int_value<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
        self.value =
            std::option::Option::Some(crate::model::attribute_value::Value::IntValue(v.into()));
        self
    }

    /// The value of [value][crate::model::AttributeValue::value]
    /// if it holds a `BoolValue`, `None` if the field is not set or
    /// holds a different branch.
    pub fn bool_value(&self) -> std::option::Option<&bool> {
        #[allow(unreachable_patterns)]
        self.value.as_ref().and_then(|v| match v {
            crate::model::attribute_value::Value::BoolValue(v) => std::option::Option::Some(v),
            _ => std::option::Option::None,
        })
    }

    /// Sets the value of [value][crate::model::AttributeValue::value]
    /// to hold a `BoolValue`.
    ///
    /// Note that all the setters affecting `value` are
    /// mutually exclusive.
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::AttributeValue;
    /// let x = AttributeValue::new().set_bool_value(true);
    /// assert!(x.bool_value().is_some());
    /// assert!(x.string_value().is_none());
    /// assert!(x.int_value().is_none());
    /// ```
    pub fn set_bool_value<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.value =
            std::option::Option::Some(crate::model::attribute_value::Value::BoolValue(v.into()));
        self
    }
}

impl wkt::message::Message for AttributeValue {
    fn typename() -> &'static str {
        "type.googleapis.com/google.devtools.cloudtrace.v2.AttributeValue"
    }
}

/// Defines additional types related to [AttributeValue].
pub mod attribute_value {
    #[allow(unused_imports)]
    use super::*;

    /// The type of the value.
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum Value {
        /// A string up to 256 bytes long.
        StringValue(std::boxed::Box<crate::model::TruncatableString>),
        /// A 64-bit signed integer.
        IntValue(i64),
        /// A Boolean value represented by `true` or `false`.
        BoolValue(bool),
    }
}

/// A call stack appearing in a trace.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct StackTrace {
    /// Stack frames in this stack trace. A maximum of 128 frames are allowed.
    pub stack_frames: std::option::Option<crate::model::stack_trace::StackFrames>,

    /// The hash ID is used to conserve network bandwidth for duplicate
    /// stack traces within a single trace.
    ///
    /// Often multiple spans will have identical stack traces.
    /// The first occurrence of a stack trace should contain both the
    /// `stackFrame` content and a value in `stackTraceHashId`.
    ///
    /// Subsequent spans within the same request can refer
    /// to that stack trace by only setting `stackTraceHashId`.
    pub stack_trace_hash_id: i64,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl StackTrace {
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [stack_frames][crate::model::StackTrace::stack_frames].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::StackTrace;
    /// use google_cloud_trace_v2::model::stack_trace::StackFrames;
    /// let x = StackTrace::new().set_stack_frames(StackFrames::default()/* use setters */);
    /// ```
    pub fn set_stack_frames<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::stack_trace::StackFrames>,
    {
        self.stack_frames = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [stack_frames][crate::model::StackTrace::stack_frames].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::StackTrace;
    /// use google_cloud_trace_v2::model::stack_trace::StackFrames;
    /// let x = StackTrace::new().set_or_clear_stack_frames(Some(StackFrames::default()/* use setters */));
    /// let x = StackTrace::new().set_or_clear_stack_frames(None::<StackFrames>);
    /// ```
    pub fn set_or_clear_stack_frames<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::stack_trace::StackFrames>,
    {
        self.stack_frames = v.map(|x| x.into());
        self
    }

    /// Sets the value of [stack_trace_hash_id][crate::model::StackTrace::stack_trace_hash_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::StackTrace;
    /// let x = StackTrace::new().set_stack_trace_hash_id(42);
    /// ```
    pub fn set_stack_trace_hash_id<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
        self.stack_trace_hash_id = v.into();
        self
    }
}

impl wkt::message::Message for StackTrace {
    fn typename() -> &'static str {
        "type.googleapis.com/google.devtools.cloudtrace.v2.StackTrace"
    }
}

/// Defines additional types related to [StackTrace].
pub mod stack_trace {
    #[allow(unused_imports)]
    use super::*;

    /// Represents a single stack frame in a stack trace.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct StackFrame {
        /// The fully-qualified name that uniquely identifies the function or
        /// method that is active in this frame (up to 1024 bytes).
        pub function_name: std::option::Option<crate::model::TruncatableString>,

        /// An un-mangled function name, if `function_name` is mangled.
        /// To get information about name mangling, run
        /// [this search](https://www.google.com/search?q=cxx+name+mangling).
        /// The name can be fully-qualified (up to 1024 bytes).
        pub original_function_name: std::option::Option<crate::model::TruncatableString>,

        /// The name of the source file where the function call appears (up to 256
        /// bytes).
        pub file_name: std::option::Option<crate::model::TruncatableString>,

        /// The line number in `file_name` where the function call appears.
        pub line_number: i64,

        /// The column number where the function call appears, if available.
        /// This is important in JavaScript because of its anonymous functions.
        pub column_number: i64,

        /// The binary module from where the code was loaded.
        pub load_module: std::option::Option<crate::model::Module>,

        /// The version of the deployed source code (up to 128 bytes).
        pub source_version: std::option::Option<crate::model::TruncatableString>,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl StackFrame {
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [function_name][crate::model::stack_trace::StackFrame::function_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::TruncatableString;
        /// let x = StackFrame::new().set_function_name(TruncatableString::default()/* use setters */);
        /// ```
        pub fn set_function_name<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::TruncatableString>,
        {
            self.function_name = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [function_name][crate::model::stack_trace::StackFrame::function_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::TruncatableString;
        /// let x = StackFrame::new().set_or_clear_function_name(Some(TruncatableString::default()/* use setters */));
        /// let x = StackFrame::new().set_or_clear_function_name(None::<TruncatableString>);
        /// ```
        pub fn set_or_clear_function_name<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::TruncatableString>,
        {
            self.function_name = v.map(|x| x.into());
            self
        }

        /// Sets the value of [original_function_name][crate::model::stack_trace::StackFrame::original_function_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::TruncatableString;
        /// let x = StackFrame::new().set_original_function_name(TruncatableString::default()/* use setters */);
        /// ```
        pub fn set_original_function_name<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::TruncatableString>,
        {
            self.original_function_name = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [original_function_name][crate::model::stack_trace::StackFrame::original_function_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::TruncatableString;
        /// let x = StackFrame::new().set_or_clear_original_function_name(Some(TruncatableString::default()/* use setters */));
        /// let x = StackFrame::new().set_or_clear_original_function_name(None::<TruncatableString>);
        /// ```
        pub fn set_or_clear_original_function_name<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::TruncatableString>,
        {
            self.original_function_name = v.map(|x| x.into());
            self
        }

        /// Sets the value of [file_name][crate::model::stack_trace::StackFrame::file_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::TruncatableString;
        /// let x = StackFrame::new().set_file_name(TruncatableString::default()/* use setters */);
        /// ```
        pub fn set_file_name<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::TruncatableString>,
        {
            self.file_name = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [file_name][crate::model::stack_trace::StackFrame::file_name].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::TruncatableString;
        /// let x = StackFrame::new().set_or_clear_file_name(Some(TruncatableString::default()/* use setters */));
        /// let x = StackFrame::new().set_or_clear_file_name(None::<TruncatableString>);
        /// ```
        pub fn set_or_clear_file_name<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::TruncatableString>,
        {
            self.file_name = v.map(|x| x.into());
            self
        }

        /// Sets the value of [line_number][crate::model::stack_trace::StackFrame::line_number].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// let x = StackFrame::new().set_line_number(42);
        /// ```
        pub fn set_line_number<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
            self.line_number = v.into();
            self
        }

        /// Sets the value of [column_number][crate::model::stack_trace::StackFrame::column_number].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// let x = StackFrame::new().set_column_number(42);
        /// ```
        pub fn set_column_number<T: std::convert::Into<i64>>(mut self, v: T) -> Self {
            self.column_number = v.into();
            self
        }

        /// Sets the value of [load_module][crate::model::stack_trace::StackFrame::load_module].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::Module;
        /// let x = StackFrame::new().set_load_module(Module::default()/* use setters */);
        /// ```
        pub fn set_load_module<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::Module>,
        {
            self.load_module = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [load_module][crate::model::stack_trace::StackFrame::load_module].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::Module;
        /// let x = StackFrame::new().set_or_clear_load_module(Some(Module::default()/* use setters */));
        /// let x = StackFrame::new().set_or_clear_load_module(None::<Module>);
        /// ```
        pub fn set_or_clear_load_module<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::Module>,
        {
            self.load_module = v.map(|x| x.into());
            self
        }

        /// Sets the value of [source_version][crate::model::stack_trace::StackFrame::source_version].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::TruncatableString;
        /// let x = StackFrame::new().set_source_version(TruncatableString::default()/* use setters */);
        /// ```
        pub fn set_source_version<T>(mut self, v: T) -> Self
        where
            T: std::convert::Into<crate::model::TruncatableString>,
        {
            self.source_version = std::option::Option::Some(v.into());
            self
        }

        /// Sets or clears the value of [source_version][crate::model::stack_trace::StackFrame::source_version].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// use google_cloud_trace_v2::model::TruncatableString;
        /// let x = StackFrame::new().set_or_clear_source_version(Some(TruncatableString::default()/* use setters */));
        /// let x = StackFrame::new().set_or_clear_source_version(None::<TruncatableString>);
        /// ```
        pub fn set_or_clear_source_version<T>(mut self, v: std::option::Option<T>) -> Self
        where
            T: std::convert::Into<crate::model::TruncatableString>,
        {
            self.source_version = v.map(|x| x.into());
            self
        }
    }

    impl wkt::message::Message for StackFrame {
        fn typename() -> &'static str {
            "type.googleapis.com/google.devtools.cloudtrace.v2.StackTrace.StackFrame"
        }
    }

    /// A collection of stack frames, which can be truncated.
    #[derive(Clone, Default, PartialEq)]
    #[non_exhaustive]
    pub struct StackFrames {
        /// Stack frames in this call stack.
        pub frame: std::vec::Vec<crate::model::stack_trace::StackFrame>,

        /// The number of stack frames that were dropped because there
        /// were too many stack frames.
        /// If this value is 0, then no stack frames were dropped.
        pub dropped_frames_count: i32,

        pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
    }

    impl StackFrames {
        pub fn new() -> Self {
            std::default::Default::default()
        }

        /// Sets the value of [frame][crate::model::stack_trace::StackFrames::frame].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrames;
        /// use google_cloud_trace_v2::model::stack_trace::StackFrame;
        /// let x = StackFrames::new()
        ///     .set_frame([
        ///         StackFrame::default()/* use setters */,
        ///         StackFrame::default()/* use (different) setters */,
        ///     ]);
        /// ```
        pub fn set_frame<T, V>(mut self, v: T) -> Self
        where
            T: std::iter::IntoIterator<Item = V>,
            V: std::convert::Into<crate::model::stack_trace::StackFrame>,
        {
            use std::iter::Iterator;
            self.frame = v.into_iter().map(|i| i.into()).collect();
            self
        }

        /// Sets the value of [dropped_frames_count][crate::model::stack_trace::StackFrames::dropped_frames_count].
        ///
        /// # Example
        /// ```ignore,no_run
        /// # use google_cloud_trace_v2::model::stack_trace::StackFrames;
        /// let x = StackFrames::new().set_dropped_frames_count(42);
        /// ```
        pub fn set_dropped_frames_count<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
            self.dropped_frames_count = v.into();
            self
        }
    }

    impl wkt::message::Message for StackFrames {
        fn typename() -> &'static str {
            "type.googleapis.com/google.devtools.cloudtrace.v2.StackTrace.StackFrames"
        }
    }
}

/// Binary module.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Module {
    /// For example: main binary, kernel modules, and dynamic libraries
    /// such as libc.so, sharedlib.so (up to 256 bytes).
    pub module: std::option::Option<crate::model::TruncatableString>,

    /// A unique identifier for the module, usually a hash of its
    /// contents (up to 128 bytes).
    pub build_id: std::option::Option<crate::model::TruncatableString>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Module {
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [module][crate::model::Module::module].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Module;
    /// use google_cloud_trace_v2::model::TruncatableString;
    /// let x = Module::new().set_module(TruncatableString::default()/* use setters */);
    /// ```
    pub fn set_module<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TruncatableString>,
    {
        self.module = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [module][crate::model::Module::module].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Module;
    /// use google_cloud_trace_v2::model::TruncatableString;
    /// let x = Module::new().set_or_clear_module(Some(TruncatableString::default()/* use setters */));
    /// let x = Module::new().set_or_clear_module(None::<TruncatableString>);
    /// ```
    pub fn set_or_clear_module<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TruncatableString>,
    {
        self.module = v.map(|x| x.into());
        self
    }

    /// Sets the value of [build_id][crate::model::Module::build_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Module;
    /// use google_cloud_trace_v2::model::TruncatableString;
    /// let x = Module::new().set_build_id(TruncatableString::default()/* use setters */);
    /// ```
    pub fn set_build_id<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TruncatableString>,
    {
        self.build_id = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [build_id][crate::model::Module::build_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::Module;
    /// use google_cloud_trace_v2::model::TruncatableString;
    /// let x = Module::new().set_or_clear_build_id(Some(TruncatableString::default()/* use setters */));
    /// let x = Module::new().set_or_clear_build_id(None::<TruncatableString>);
    /// ```
    pub fn set_or_clear_build_id<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TruncatableString>,
    {
        self.build_id = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for Module {
    fn typename() -> &'static str {
        "type.googleapis.com/google.devtools.cloudtrace.v2.Module"
    }
}

/// Represents a string that might be shortened to a specified length.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct TruncatableString {
    /// The shortened string. For example, if the original string is 500
    /// bytes long and the limit of the string is 128 bytes, then
    /// `value` contains the first 128 bytes of the 500-byte string.
    ///
    /// Truncation always happens on a UTF8 character boundary. If there
    /// are multi-byte characters in the string, then the length of the
    /// shortened string might be less than the size limit.
    pub value: std::string::String,

    /// The number of bytes removed from the original string. If this
    /// value is 0, then the string was not shortened.
    pub truncated_byte_count: i32,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl TruncatableString {
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [value][crate::model::TruncatableString::value].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::TruncatableString;
    /// let x = TruncatableString::new().set_value("example");
    /// ```
    pub fn set_value<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.value = v.into();
        self
    }

    /// Sets the value of [truncated_byte_count][crate::model::TruncatableString::truncated_byte_count].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::TruncatableString;
    /// let x = TruncatableString::new().set_truncated_byte_count(42);
    /// ```
    pub fn set_truncated_byte_count<T: std::convert::Into<i32>>(mut self, v: T) -> Self {
        self.truncated_byte_count = v.into();
        self
    }
}

impl wkt::message::Message for TruncatableString {
    fn typename() -> &'static str {
        "type.googleapis.com/google.devtools.cloudtrace.v2.TruncatableString"
    }
}

/// The request message for the `BatchWriteSpans` method.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct BatchWriteSpansRequest {
    /// Required. The name of the project where the spans belong. The format is
    /// `projects/[PROJECT_ID]`.
    pub name: std::string::String,

    /// Required. A list of new spans. The span names must not match existing
    /// spans, otherwise the results are undefined.
    pub spans: std::vec::Vec<crate::model::Span>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl BatchWriteSpansRequest {
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::BatchWriteSpansRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::BatchWriteSpansRequest;
    /// let x = BatchWriteSpansRequest::new().set_name("example");
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [spans][crate::model::BatchWriteSpansRequest::spans].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_cloud_trace_v2::model::BatchWriteSpansRequest;
    /// use google_cloud_trace_v2::model::Span;
    /// let x = BatchWriteSpansRequest::new()
    ///     .set_spans([
    ///         Span::default()/* use setters */,
    ///         Span::default()/* use (different) setters */,
    ///     ]);
    /// ```
    pub fn set_spans<T, V>(mut self, v: T) -> Self
    where
        T: std::iter::IntoIterator<Item = V>,
        V: std::convert::Into<crate::model::Span>,
    {
        use std::iter::Iterator;
        self.spans = v.into_iter().map(|i| i.into()).collect();
        self
    }
}

impl wkt::message::Message for BatchWriteSpansRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.devtools.cloudtrace.v2.BatchWriteSpansRequest"
    }
}