Struct GmailAccountSettings 

pub struct GmailAccountSettings {
    pub client_id: Option<String>,
    pub client_secret: Option<String>,
    pub refresh_token: Option<String>,
    pub scope: Option<String>,
    pub email_address: Option<String>,
    pub chrome_profile_from_email: bool,
    pub browser_command: Option<String>,
}

A single named Gmail account’s stored OAuth2 credentials, inside the gmail.accounts map (issue #1500, ADR-0066).

Orthogonal to Profile: selecting a Gmail account never changes the active --profile, and vice versa. See email_address’s own doc comment below for how it’s populated and used — never for authentication itself.

Fields

client_id: Option<String>

OAuth2 client id from the account’s Google Cloud project.

client_secret: Option<String>

OAuth2 client secret from the account’s Google Cloud project.

refresh_token: Option<String>

The long-lived refresh token obtained by gmail auth login.

scope: Option<String>

The OAuth2 scope this account was authorized with.

email_address: Option<String>

Mailbox address for this account. Populated opportunistically by gmail auth status when absent, but may also be set by hand ahead of the first login — e.g. to opt into chrome_profile_from_email below. An explicit value is never overwritten by the gmail auth status backfill. Never used for authentication itself, only for browser targeting.

chrome_profile_from_email: bool

Opt-in (default false): resolve which local Chrome profile is signed into email_address and launch gmail auth login’s authorization URL targeting that profile, instead of the OS default browser. Resolution failure (Chrome not installed, zero or multiple matching profiles, …) always falls back to the default browser — never a hard login failure. Ignored when browser_command is set. (issue #1505, ADR-0067)

browser_command: Option<String>

Explicit browser launch command for gmail auth login, {url} templated (or appended if no placeholder is present) — the manual escape hatch, e.g. to target a specific Chrome profile by hand or a non-Chrome browser entirely. Mirrors SNOWFLAKE_BROWSER_COMMAND (crate::snowflake). Takes precedence over chrome_profile_from_email. (issue #1505)

Trait Implementations

impl Debug for GmailAccountSettings

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

Formats the value using the given formatter.

impl Default for GmailAccountSettings

fn default() -> GmailAccountSettings

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GmailAccountSettings

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.