az-gmail-code 2026.5.10

Authorized Gmail API client for reading verification codes from owned mailboxes
Documentation 
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

use serde::{Deserialize, Serialize};
use serde_json::Value;
use std::collections::BTreeMap;

/// Verification code extracted from a Gmail message.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ExtractedGmailCode {
    /// Numeric verification code.
    pub code: String,
    /// Gmail message id containing the code.
    pub message_id: String,
    /// Optional thread id returned by Gmail.
    pub thread_id: Option<String>,
    /// Best-effort sender header.
    pub from: Option<String>,
    /// Best-effort subject header.
    pub subject: Option<String>,
    /// MIME type of the body candidate that produced the code.
    pub source_mime_type: String,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub(crate) struct GmailListMessagesResponse {
    #[serde(default)]
    pub(crate) messages: Vec<GmailMessageSummary>,
    #[serde(default, rename = "nextPageToken")]
    pub(crate) next_page_token: Option<String>,
    #[serde(default, rename = "resultSizeEstimate")]
    pub(crate) result_size_estimate: Option<u32>,
}

#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub(crate) struct GmailMessageSummary {
    pub(crate) id: String,
    #[serde(default, rename = "threadId")]
    pub(crate) thread_id: Option<String>,
}

/// Gmail message shape needed for verification-code extraction.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct GmailMessage {
    /// Gmail message id.
    pub id: String,
    /// Optional Gmail thread id.
    #[serde(default, rename = "threadId")]
    pub thread_id: Option<String>,
    /// MIME tree root.
    #[serde(default)]
    pub payload: Option<GmailMessagePart>,
    /// Short text snippet returned by Gmail.
    #[serde(default)]
    pub snippet: Option<String>,
    /// Extra Gmail fields not modeled by this crate.
    #[serde(flatten)]
    pub extra: BTreeMap<String, Value>,
}

impl GmailMessage {
    /// Returns a header value from the root payload, case-insensitively.
    #[must_use]
    pub fn header(&self, name: &str) -> Option<&str> {
        self.payload.as_ref()?.header(name)
    }
}

/// One part of a Gmail MIME message tree.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct GmailMessagePart {
    /// Gmail part id.
    #[serde(default, rename = "partId")]
    pub part_id: Option<String>,
    /// MIME type, for example `text/plain` or `text/html`.
    #[serde(default, rename = "mimeType")]
    pub mime_type: String,
    /// Message headers for this part.
    #[serde(default)]
    pub headers: Vec<GmailMessageHeader>,
    /// Body metadata and inline payload.
    #[serde(default)]
    pub body: Option<GmailMessagePartBody>,
    /// Child MIME parts.
    #[serde(default)]
    pub parts: Vec<GmailMessagePart>,
}

impl GmailMessagePart {
    /// Returns a header value from this part, case-insensitively.
    #[must_use]
    pub fn header(&self, name: &str) -> Option<&str> {
        self.headers
            .iter()
            .find(|header| header.name.eq_ignore_ascii_case(name))
            .map(|header| header.value.as_str())
    }
}

/// Gmail MIME header.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct GmailMessageHeader {
    /// Header name.
    pub name: String,
    /// Header value.
    pub value: String,
}

/// Gmail message body metadata and inline payload.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct GmailMessagePartBody {
    #[serde(default)]
    pub data: Option<String>,
    #[serde(default)]
    pub size: Option<u64>,
    #[serde(default, rename = "attachmentId")]
    pub attachment_id: Option<String>,
}