1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

/// 5.1 Native Markup Response Object
///
/// The native object is the top level JSON object which identifies a native response. The native
/// object has following attributes:
#[derive(serde::Serialize, serde::Deserialize, Default, Debug, PartialEq, Clone)]
pub struct Response<'a> {
    /// recommended; string; 1.2
    /// Version of the Native Markup version in use.
    #[serde(default)]
    pub ver: crate::Version,

    /// recommended; array of object; -
    /// List of native ad’s assets. Required if no assetsurl. Recommended as fallback even if
    /// assetsurl is provided.
    #[serde(borrow, default, skip_serializing_if = "Option::is_none")]
    pub assets: Option<Vec<crate::response::Asset<'a>>>,

    /// optional; string; -
    /// URL of an alternate source for the assets object. The expected response is a JSON object
    /// mirroring the assets object in the bid response, subject to certain requirements as
    /// specified in the individual objects. Where present, overrides the asset object in the
    /// response.
    #[serde(borrow, default, skip_serializing_if = "Option::is_none")]
    pub assetsurl: Option<std::borrow::Cow<'a, str>>,

    /// optional; string; -
    /// URL where a dynamic creative specification may be found for populating this ad, per the
    /// Dynamic Content Ads Specification. Note this is a beta option as the interpretation of the
    /// Dynamic Content Ads Specification and how to assign those elements into a native ad is
    /// outside the scope of this spec and must be agreed offline between the parties or as may be
    /// specified in a future revision of the Dynamic Content Ads spec. Where present, overrides
    /// the asset object in the response.
    #[serde(borrow, default, skip_serializing_if = "Option::is_none")]
    pub dcourl: Option<std::borrow::Cow<'a, str>>,

    /// required; object; -
    /// Destination Link. This is default link object for the ad. Individual assets can also have a
    /// link object which applies if the asset is activated(clicked). If the asset doesn’t have a
    /// link object, the parent link object applies. See LinkObject Definition.
    pub link: crate::response::Link<'a>,

    /// optional; array of string; -
    /// Array of impression tracking URLs, expected to return a 1x1 image or 204 response -
    /// typically only passed when using 3rd party trackers. To be deprecated - replaced with
    /// eventtrackers.
    #[serde(borrow, default, skip_serializing_if = "Option::is_none")]
    #[deprecated = "Please use eventtrackers field instead."]
    pub imptrackers: Option<Vec<std::borrow::Cow<'a, str>>>,

    /// optional; string; -
    /// Optional JavaScript impression tracker. This is a valid HTML, Javascript is already wrapped
    /// in <script> tags. It should be executed at impression time where it can be supported. To be
    /// deprecated - replaced with eventtrackers.
    #[serde(borrow, default, skip_serializing_if = "Option::is_none")]
    #[deprecated = "Please use eventtrackers field instead."]
    pub jstracker: Option<std::borrow::Cow<'a, str>>,

    /// optional; Array of object; -
    /// Array of tracking objects to run with the ad, in response to the declared supported methods
    /// in the request. Replaces imptrackers and jstracker, to be deprecated.
    #[serde(borrow, default, skip_serializing_if = "Option::is_none")]
    pub eventtrackers: Option<Vec<crate::response::EventTracker<'a>>>,

    /// optional; string; -
    /// If support was indicated in the request, URL of a page informing the user about the buyer’s
    /// targeting activity.
    #[serde(borrow, default, skip_serializing_if = "Option::is_none")]
    pub privacy: Option<std::borrow::Cow<'a, str>>,

    /// optional; object; -
    /// This object is a placeholder that may contain custom JSON agreed to by the parties to
    /// support flexibility beyond the standard defined in this specification.
    #[serde(borrow, default, skip_serializing_if = "Option::is_none")]
    pub ext: Option<json_ext::Object<'a>>,
}

#[cfg(test)]
mod test {
    use super::*;

    #[test]
    fn json() -> serde_json::Result<()> {
        let json = r#"{"ver":"1.2","link":{"url":""}}"#;
        let o1 = Response::default();
        assert_eq!(serde_json::to_string(&o1)?, json);
        assert_eq!(o1, serde_json::from_str::<Response>(json)?);

        Ok(())
    }
}