Struct HistoryApi 

pub struct HistoryApi<'a> { /* private fields */ }

History API façade.

Implementations

impl<'a> HistoryApi<'a>

pub fn new(client: &'a GmailClient) -> Self

Wraps an existing GmailClient for history operations.

pub async fn list( &self, start_history_id: &str, history_types: &[&str], limit: usize, page_token: Option<&str>, ) -> Result<HistoryListResponse>

Lists mailbox changes since start_history_id, returning a single page.

Google returns 404 notFound when start_history_id is older than the mailbox’s retention window (about a week); gmail sync catches that specific case and falls back to a full reconciliation pass.

pub async fn list_all( &self, start_history_id: &str, history_types: &[&str], limit: usize, ) -> Result<HistoryListResponse>

Lists mailbox changes since start_history_id, auto-paginating via cursor as needed. limit == 0 means “fetch every change up to HARD_CAP” — a deliberate safety limit for this general-purpose entry point. See Self::list_all_unbounded for the one caller that must not have it.

Trait Implementations

impl<'a> Debug for HistoryApi<'a>

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

Formats the value using the given formatter.