Crate graph_rs_sdk

Expand description

Microsoft Graph API Client in Rust

graph-rs is an API client for Microsoft Graph V1.0 and Graph Beta.

Installation and basic usage can be found below and there are extensive examples in the example’s directory on GitHub](https://github.com/sreeise/graph-rs).

What Api’s are available

The Api’s available are generated from Microsoft’s msgraph-metadata repository which stores OpenApi configs for the Graph Api. There may be some requests and/or Api’s not yet included in this project but in general most of them are implemented.

Feature requests or Bug reports.

For both feature requests and bug reports please file an issue on GitHub and a response or fix will be done as soon as possible.

Use

The client supports both blocking and async requests.

Blocking Client

To use the blocking client

use graph_rs_sdk::prelude::*;

let client =  Graph::new("ACCESS_TOKEN");

Async Client

To use the async client

use graph_rs_sdk::prelude::*;

let client =  Graph::new_async("ACCESS_TOKEN");

The send method and Graph types

The send() method is the main method for sending a request. If there are no errors the return value will be wrapped in a response object and the body will be one of:

serde_json::Value
NoContent (204 responses that return a content field) This is always represented as a serde_json::Value::String and sometimes includes some basic info depending on the request.

Basic Use:

use graph_rs_sdk::prelude::*;

let client =  Graph::new("ACCESS_TOKEN");

let response = client.v1()
    .me()
    .drive()
    .get_drive()
    .send()
    .unwrap();

// Print the value returned in the body of the response
println!("{:#?}", response.body());

Using the Async Client

use graph_rs_sdk::prelude::*;

let client =  Graph::new_async("ACCESS_TOKEN");

let response = client.v1()
    .me()
    .drive()
    .get_drive()
    .send()
    .await
    .unwrap();

println!("{:#?}", response);

Use the Graph version one or beta Api

v1() refers to the endpoint for version 1 of the Microsoft graph Api. You can also use the beta() method which uses the Microsoft graph beta Api endpoint.

use graph_rs_sdk::prelude::*;

let client =  Graph::new_async("ACCESS_TOKEN");

let _response = client.beta()
    .me()
    .get_user()
    .send()?;

For more information and examples please see the repository on GitHub
If you run into issues related to graph-rs specifically please file an issue on GitHub