Struct MsgraphClientStd 

pub struct MsgraphClientStd {
    pub stream: Box<dyn MsgraphStream>,
    pub auth: HttpAuthBearer,
    pub user_id: String,
}

Available on crate feature client only.

Std blocking Microsoft Graph client: a stream, the bearer credential and the mailbox owner, with one method per operation.

Fields

stream: Box<dyn MsgraphStream>

The stream carrying the HTTPS connection to the Graph API.

auth: HttpAuthBearer

The bearer credential added to every request.

user_id: String

The mailbox owner: me, a user id or a principal name.

Implementations

impl MsgraphClientStd

pub fn new<S: Read + Write + Send + 'static>( stream: S, token: impl ToString, options: MsgraphClientStdConnectOptions, ) -> Self

Builds a client over a caller-managed stream.

pub fn connect( token: impl ToString, options: MsgraphClientStdConnectOptions, ) -> Result<Self, MsgraphClientStdError>

Available on crate features native-tls or rustls-aws or rustls-ring only.

Builds a client by opening a TCP/TLS connection to the Graph API endpoint through pimalaya-stream.

pub fn set_stream<S: Read + Write + Send + 'static>(&mut self, stream: S)

Replaces the underlying stream (e.g. after a connection reset).

pub fn run<C, T>( &mut self, coroutine: C, ) -> Result<MsgraphSendOutput<T>, MsgraphClientStdError>

where C: MsgraphCoroutine<Yield = MsgraphYield, Return = Result<MsgraphSendOutput<T>, MsgraphSendError>>,

Runs the given coroutine to completion against the stream, fulfilling its read and write requests.

pub fn batch( &mut self, requests: &[MsgraphBatchRequest], ) -> Result<MsgraphSendOutput<MsgraphBatchResponses>, MsgraphClientStdError>

Sends several requests in one HTTP call.

pub fn me( &mut self, ) -> Result<MsgraphSendOutput<MsgraphUser>, MsgraphClientStdError>

Gets the profile of the mailbox owner.

pub fn mail_folders_list( &mut self, params: &MsgraphMailFoldersListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphMailFoldersListResponse>, MsgraphClientStdError>

Lists the mail folders of the mailbox.

pub fn mail_folder_get( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphMailFolder>, MsgraphClientStdError>

Gets a mail folder by id.

pub fn mail_folder_create( &mut self, folder: &MsgraphMailFolder, ) -> Result<MsgraphSendOutput<MsgraphMailFolder>, MsgraphClientStdError>

Creates a mail folder.

pub fn mail_folder_update( &mut self, id: &str, folder: &MsgraphMailFolder, ) -> Result<MsgraphSendOutput<MsgraphMailFolder>, MsgraphClientStdError>

Updates a mail folder by id.

pub fn mail_folder_delete( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Deletes a mail folder by id.

pub fn mail_folder_copy( &mut self, id: &str, destination: &str, ) -> Result<MsgraphSendOutput<MsgraphMailFolder>, MsgraphClientStdError>

Copies a mail folder into a destination folder.

pub fn mail_folder_move( &mut self, id: &str, destination: &str, ) -> Result<MsgraphSendOutput<MsgraphMailFolder>, MsgraphClientStdError>

Moves a mail folder into a destination folder.

pub fn mail_child_folders_list( &mut self, id: &str, params: &MsgraphMailFoldersListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphMailFoldersListResponse>, MsgraphClientStdError>

Lists the child folders of a mail folder.

pub fn contact_folders_list( &mut self, params: &MsgraphContactFoldersListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphContactFoldersListResponse>, MsgraphClientStdError>

Lists the contact folders of the mailbox.

pub fn contact_folder_get( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphContactFolder>, MsgraphClientStdError>

Gets a contact folder by id.

pub fn contact_folder_create( &mut self, folder: &MsgraphContactFolder, ) -> Result<MsgraphSendOutput<MsgraphContactFolder>, MsgraphClientStdError>

Creates a contact folder.

pub fn contact_folder_update( &mut self, id: &str, folder: &MsgraphContactFolder, ) -> Result<MsgraphSendOutput<MsgraphContactFolder>, MsgraphClientStdError>

Updates a contact folder by id.

pub fn contact_folder_delete( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Deletes a contact folder by id.

pub fn contact_child_folders_list( &mut self, id: &str, params: &MsgraphContactFoldersListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphContactFoldersListResponse>, MsgraphClientStdError>

Lists the child folders of a contact folder.

pub fn contacts_list( &mut self, folder: Option<&str>, params: &MsgraphContactsListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphContactsListResponse>, MsgraphClientStdError>

Lists the contacts of the default Contacts folder, or of the given contact folder.

pub fn contact_get( &mut self, id: &str, expand: Option<&str>, ) -> Result<MsgraphSendOutput<MsgraphContact>, MsgraphClientStdError>

Gets a contact by id, optionally expanding the given relations.

pub fn contact_create( &mut self, folder: Option<&str>, contact: &MsgraphContact, ) -> Result<MsgraphSendOutput<MsgraphContact>, MsgraphClientStdError>

Creates a contact in the default Contacts folder, or in the given contact folder.

pub fn contact_update( &mut self, id: &str, contact: &MsgraphContact, ) -> Result<MsgraphSendOutput<MsgraphContact>, MsgraphClientStdError>

Updates a contact by id.

pub fn contact_delete( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Deletes a contact by id.

pub fn contacts_delta( &mut self, folder: Option<&str>, select: Option<&str>, ) -> Result<MsgraphSendOutput<MsgraphContactsDeltaResponse>, MsgraphClientStdError>

Starts a contacts delta round over the default Contacts folder, or over the given contact folder.

pub fn contacts_delta_from_link( &mut self, link: &str, ) -> Result<MsgraphSendOutput<MsgraphContactsDeltaResponse>, MsgraphClientStdError>

Continues a contacts delta round from an @odata.nextLink, or starts the next round from a saved @odata.deltaLink.

pub fn contacts_delta_with_page_size( &mut self, folder: Option<&str>, select: Option<&str>, max_page_size: Option<u32>, ) -> Result<MsgraphSendOutput<MsgraphContactsDeltaResponse>, MsgraphClientStdError>

Starts a contacts delta round like contacts_delta, asking for at most max_page_size contacts per page when given.

pub fn contacts_delta_from_link_with_page_size( &mut self, link: &str, max_page_size: Option<u32>, ) -> Result<MsgraphSendOutput<MsgraphContactsDeltaResponse>, MsgraphClientStdError>

Follows a contacts delta link like contacts_delta_from_link, asking for at most max_page_size items per page when given.

pub fn calendars_list( &mut self, params: &MsgraphCalendarsListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphCalendarsListResponse>, MsgraphClientStdError>

Lists the user’s calendars.

pub fn calendar_get( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphCalendar>, MsgraphClientStdError>

Gets the calendar id.

pub fn calendar_create( &mut self, calendar: &MsgraphCalendar, ) -> Result<MsgraphSendOutput<MsgraphCalendar>, MsgraphClientStdError>

Creates a calendar.

pub fn calendar_update( &mut self, id: &str, calendar: &MsgraphCalendar, ) -> Result<MsgraphSendOutput<MsgraphCalendar>, MsgraphClientStdError>

Patches the calendar id.

pub fn calendar_delete( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Deletes the calendar id.

pub fn events_list( &mut self, calendar: Option<&str>, params: &MsgraphEventsListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphEventsListResponse>, MsgraphClientStdError>

Lists the lone events and series masters of a calendar, the default one when calendar is None.

pub fn events_list_from_link( &mut self, link: &str, ) -> Result<MsgraphSendOutput<MsgraphEventsListResponse>, MsgraphClientStdError>

Continues an events listing from an @odata.nextLink.

pub fn event_get( &mut self, id: &str, select: Option<&str>, expand: Option<&str>, ) -> Result<MsgraphSendOutput<MsgraphEvent>, MsgraphClientStdError>

Gets the event id, selecting select and expanding expand when given.

pub fn event_create( &mut self, calendar: Option<&str>, event: &MsgraphEvent, ) -> Result<MsgraphSendOutput<MsgraphEvent>, MsgraphClientStdError>

Creates an event in a calendar, the default one when calendar is None.

pub fn event_update( &mut self, id: &str, event: &MsgraphEvent, ) -> Result<MsgraphSendOutput<MsgraphEvent>, MsgraphClientStdError>

Patches the event id.

pub fn event_delete( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Deletes the event id, the whole series for a series master.

pub fn event_instances( &mut self, id: &str, start: &str, end: &str, params: &MsgraphEventsListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphEventsListResponse>, MsgraphClientStdError>

Lists the instances of the series master id within a window.

pub fn calendar_view( &mut self, calendar: Option<&str>, start: &str, end: &str, params: &MsgraphEventsListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphEventsListResponse>, MsgraphClientStdError>

Lists a calendar view, every event expanded within a window.

pub fn events_delta( &mut self, calendar: Option<&str>, start: &str, end: &str, ) -> Result<MsgraphSendOutput<MsgraphEventsDeltaResponse>, MsgraphClientStdError>

Starts a calendar view delta round over a window.

pub fn events_delta_from_link( &mut self, link: &str, ) -> Result<MsgraphSendOutput<MsgraphEventsDeltaResponse>, MsgraphClientStdError>

Continues or restarts a calendar view delta round from a link.

pub fn events_delta_with_page_size( &mut self, calendar: Option<&str>, start: &str, end: &str, max_page_size: Option<u32>, ) -> Result<MsgraphSendOutput<MsgraphEventsDeltaResponse>, MsgraphClientStdError>

Starts a calendar view delta round like events_delta, asking for at most max_page_size events per page when given.

pub fn events_delta_from_link_with_page_size( &mut self, link: &str, max_page_size: Option<u32>, ) -> Result<MsgraphSendOutput<MsgraphEventsDeltaResponse>, MsgraphClientStdError>

Follows a calendar view delta link like events_delta_from_link, asking for at most max_page_size items per page when given.

pub fn messages_list( &mut self, folder: Option<&str>, params: &MsgraphMessagesListParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphMessagesListResponse>, MsgraphClientStdError>

Lists the messages of the whole mailbox, or of the given mail folder.

pub fn message_get( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphMessage>, MsgraphClientStdError>

Gets a message by id.

pub fn message_get_raw( &mut self, id: &str, ) -> Result<MsgraphSendOutput<Vec<u8>>, MsgraphClientStdError>

Gets the raw RFC 5322 MIME content of a message by id.

pub fn message_create( &mut self, folder: Option<&str>, message: &MsgraphMessage, ) -> Result<MsgraphSendOutput<MsgraphMessage>, MsgraphClientStdError>

Creates a draft message from JSON in the Drafts folder, or in the given mail folder.

pub fn message_create_mime( &mut self, folder: Option<&str>, raw: &[u8], ) -> Result<MsgraphSendOutput<MsgraphMessage>, MsgraphClientStdError>

Creates a draft message from raw RFC 5322 MIME bytes in the Drafts folder, or in the given mail folder.

pub fn message_update( &mut self, id: &str, message: &MsgraphMessage, ) -> Result<MsgraphSendOutput<MsgraphMessage>, MsgraphClientStdError>

Updates a message by id.

pub fn message_delete( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Deletes a message by id.

pub fn message_move( &mut self, id: &str, destination: &str, ) -> Result<MsgraphSendOutput<MsgraphMessage>, MsgraphClientStdError>

Moves a message into a destination folder.

pub fn message_copy( &mut self, id: &str, destination: &str, ) -> Result<MsgraphSendOutput<MsgraphMessage>, MsgraphClientStdError>

Copies a message into a destination folder.

pub fn messages_delta( &mut self, folder: Option<&str>, select: Option<&str>, ) -> Result<MsgraphSendOutput<MsgraphMessagesDeltaResponse>, MsgraphClientStdError>

Starts a messages delta round over the whole mailbox, or over the given mail folder.

pub fn messages_delta_from_link( &mut self, link: &str, ) -> Result<MsgraphSendOutput<MsgraphMessagesDeltaResponse>, MsgraphClientStdError>

Continues a messages delta round from an @odata.nextLink, or starts the next round from a saved @odata.deltaLink.

pub fn messages_delta_with_params( &mut self, folder: Option<&str>, params: &MsgraphMessagesDeltaParams<'_>, ) -> Result<MsgraphSendOutput<MsgraphMessagesDeltaResponse>, MsgraphClientStdError>

Starts a messages delta round with the OData options and page size of params.

pub fn messages_delta_from_link_with_page_size( &mut self, link: &str, max_page_size: Option<u32>, ) -> Result<MsgraphSendOutput<MsgraphMessagesDeltaResponse>, MsgraphClientStdError>

Follows a messages delta link like messages_delta_from_link, asking for at most max_page_size messages per page when given.

pub fn attachment_create( &mut self, message_id: &str, name: &str, content: &[u8], content_type: Option<&str>, ) -> Result<MsgraphSendOutput<MsgraphAttachment>, MsgraphClientStdError>

Creates a file attachment on a message.

pub fn attachments_list( &mut self, message_id: &str, ) -> Result<MsgraphSendOutput<MsgraphAttachmentsListResponse>, MsgraphClientStdError>

Lists the attachments of a message.

pub fn attachment_get_raw( &mut self, message_id: &str, attachment_id: &str, ) -> Result<MsgraphSendOutput<Vec<u8>>, MsgraphClientStdError>

Gets the raw content of an attachment.

pub fn attachment_delete( &mut self, message_id: &str, attachment_id: &str, ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Deletes an attachment of a message.

pub fn message_send( &mut self, id: &str, ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Sends an existing draft message by id.

pub fn mail_send( &mut self, message: &MsgraphMessage, save_to_sent_items: bool, ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Sends a message described as JSON through the sendMail action.

pub fn mail_send_mime( &mut self, raw: &[u8], ) -> Result<MsgraphSendOutput<MsgraphNoResponse>, MsgraphClientStdError>

Sends a message given as raw RFC 5322 MIME bytes through the sendMail action.

Trait Implementations

impl Debug for MsgraphClientStd

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

Formats the value using the given formatter.