Struct EmailGetParams 

pub struct EmailGetParams {
    pub body_properties: Option<Vec<String>>,
    pub fetch_text_body_values: Option<bool>,
    pub fetch_html_body_values: Option<bool>,
    pub fetch_all_body_values: Option<bool>,
    pub max_body_value_bytes: Option<u64>,
    pub extra: Map<String, Value>,
}

Extra args for Email/get (RFC 8621 §4.1.8).

Controls which body properties to fetch and whether to inline body values.

Fields

body_properties: Option<Vec<String>>

Override the set of body part properties returned (RFC 8621 §4.1.8).

fetch_text_body_values: Option<bool>

If true, inline values for text/plain body parts (RFC 8621 §4.1.8).

fetch_html_body_values: Option<bool>

If true, inline values for text/html body parts (RFC 8621 §4.1.8).

Wire name is fetchHTMLBodyValues (HTML uppercase) per RFC 8621 §4.2 line 2327 and the §4.2 example at line 2438. The default camelCase serde rename would produce fetchHtmlBodyValues, which a strict server treats as an unknown invocation argument and silently drops, causing HTML body values to never be inlined.

fetch_all_body_values: Option<bool>

If true, inline values for all body parts (RFC 8621 §4.1.8).

max_body_value_bytes: Option<u64>

Truncate body values to at most this many octets (RFC 8621 §4.1.8).

When set, each returned EmailBodyValue whose UTF-8 byte length exceeds this limit is truncated; the truncation point is rounded down to a UTF-8 character boundary so the returned string is always valid UTF-8 (trailing bytes that would result in an incomplete code point are dropped). Consequently the actual returned length may be a few octets short of this limit when the cut would fall inside a multi-byte UTF-8 sequence.

Truncated EmailBodyValue objects have their isTruncated property set to true. Callers that need the full body of a truncated value should download the raw blob via JmapClient::download_blob.

Spec magic-value: Some(0) is equivalent to omitting the field — RFC 8621 §4.1.8 says “If positive, …” which means the truncation only applies for strictly-positive values. Pass None to omit the wire field entirely (server uses its default policy), or Some(n) with n > 0 for an explicit truncation cap. Passing Some(0) is wire-legal but semantically identical to omission — prefer None for clarity.

extra: Map<String, Value>

Catch-all for vendor / site / private extension fields not covered by the typed fields above. Preserves unknown fields across deserialize/serialize round-trip per workspace extras-preservation policy (see workspace AGENTS.md).

Constraint: keys in extra MUST NOT collide with the typed-field wire names above (the camelCase spelling — e.g. "accountId", "ids", "properties", "blobIds", "fromAccountId", etc.). On collision the typed-field value wins on the wire and the extra value is silently dropped at serialization. Place vendor extensions under vendor-prefixed keys (e.g. "acmeCorpFoo") to avoid the collision class.

Trait Implementations

impl Clone for EmailGetParams

fn clone(&self) -> EmailGetParams

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EmailGetParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for EmailGetParams

fn default() -> EmailGetParams

Returns the “default value” for a type.

impl Serialize for EmailGetParams

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.