SPKonferenz 2017 - Introducing SDKs for Microsoft Graph

Partner: Veranstalter:
Introducing SDKs for Microsoft Graph
Dragan Panjkov

Dragan Panjkov
Microsoft MVP – Office Servers and Services
Consultant at K2 NE (www.k2.com)
Website and blog: www.dragan-panjkov.com
Twitter: @panjkov

 Microsoft Graph API
 Microsoft Graph SDK for .NET
 Microsoft Graph SDK for JavaScript

 A unique set of API to rule all the services
 Unified endpoint
 Unique handshake and Access Token
 Unique development experience
 Unique consumption model: REST

Calendar
Office Graph
https://graph.microsoft.com
Search
Social
Mail PeopleDocuments
Designed for
openness and
flexibility
Enabling a
consistent
development
platform
Powering
a world
of devices
iOS
dev.office.com
Groups Notebooks Videos

/{version}/{tenant} /{entity-set} /{id}/{property}

Demo
Playing with the Microsoft Graph API

TASKS
manager
memberOf
FILES
MESSAGES
workingWith
Shared with me
directReports
createdBy
FILES
CONVERSATIONS
createdBy
workingWith
EVENTS
trendingAround
GROUPS
TASKS
NOTES
NOTES
public
modifiedBy
USER
trendingAround

SPKonferenz 2017 - Introducing SDKs for Microsoft Graph

 Open Source SDK
 Available for .NET and many other platforms
 Mainly auto-generated with VIPR
 Based on the $metadata descriptors
 Open Authentication Model
 Mainly supported: ADAL and MSAL
 Asynchronous by design (async/await)

 Install the NuGet package (Microsoft.Graph)
 Register your application
 Azure Active Directory
 https://manage.windowsazure.com/ or https://portal.azure.com/
 Application Registration Portal (for V2 Authentication Endpoint - Preview)
 https://apps.dev.microsoft.com/
 Prepare the authentication code/model
 Pass it to the constructor of the GraphServiceClient type
 GO!

Demo
“Hello World!” Microsoft Graph SDK

 There are auto-generated RequestBuilder types
 Implement interfaces like I*RequestBuilder
 They provide Request() method
 Which provides chain of OData querying methods
 Invoke GetAsync() method to execute request

 Replicates OData behavior and signatures
 Select() => $select
 Filter() => $filter
 OrderBy() => $orderby
 Expand() => $expand
 Provides paging capabilities
 Through NextPageRequest property on query results/collections

 Collections provide methods to manage resources
 AddAsync() => POST
 UpdateAsync() => PATCH
 PutAsync() => PUT
 DeleteAsync() => DELETE

 Reference exception type ServiceException
 Useful properties
 Error (Code, Message, InnerError, AdditionalData, etc.)
 IsMatch() method for fine handling of errors

Node
npm install @microsoft/microsoft-graph-client
const MicrosoftGraph = require("@microsoft/microsoft-graph-
client");
Browser
<script type="text/javascript" src="graph-js-sdk-web.js"></script>

var client = MicrosoftGraph.Client.init({
authProvider: (done) => {
done(null, "PassInAccessTokenHere"); //first parameter takes an error
if you can't get an access token
}
});

// get the names of my top 5 contacts on the beta endpoint
client
.api('me/people')
.version("beta") //optional, but recommeded to have before query params
.top(5)
.select("displayName")
.get((err, res) => {
const topContacts = res.value.map((u) => {return u.displayName});
console.log("Your top contacts are", topContacts.join(", "));
});

client
.api('/me/people')
.select(["displayName", "department", "title"])
.get((err, res) => {
console.log(res)
})

// construct the email object
const mail = {
subject: "Microsoft Graph JavaScript Sample",
toRecipients: [{
emailAddress: {
address: "example@example.com"
}
}],
body: {
content: "<h1>MicrosoftGraph JavaScript Sample</h1>Check out
https://github.com/microsoftgraph/msgraph-sdk-javascript",
contentType: "html"
}
}
client
.api('/users/me/sendMail')
.post({message: mail}, (err, res) => {
console.log(res)
})

// delete a OneDrive item
client
.api(´/me/drive/items/${ONE_DRIVE_FILE_ID_TO_DELETE}`)
.delete((err, res) => {
if (err) {
console.log(err)
return;
}
console.log(res)
})

var file = document.querySelector('input[type=file]').files[0];
client
.api('/me/photo/$value')
.put(file, (err, res) => {
if (err) {
console.log(err);
return;
}
console.log("We've updated your picture!");
});

// Upload a file to OneDrive
let fs = require('fs'); // requires filesystem module
let stream = fs.createReadStream('./logo.png'); //path to local
file
client
.api('/me/drive/root/children/logo.png/content') // path to
the destination in OneDrive
.put(stream, (err) => {
console.log(err);
});

const fs = require('fs'); // requires filesystem module
client
.api('/me/drive/root/children/Book.xlsx/content') // path
of source file in OneDrive
.getStream((err, downloadStream) => {
let writeStream = fs.createWriteStream('Book.xlsx'); //
path to save file to
downloadStream.pipe(writeStream).on('error',
console.log);
});

Resources
https://developer.microsoft.com/en-us/graph/
https://channel9.msdn.com/blogs/OfficeDevPnP/PnP-Web-
Cast-Introduction-to-Microsoft-Graph-NET-SDK
https://github.com/microsoftgraph/msgraph-sdk-dotnet
https://github.com/microsoftgraph/msgraph-sdk-javascript
https://github.com/microsoftgraph/angular-connect-sample
https://github.com/microsoftgraph/nodejs-connect-sample

Ich freue mich auf Ihr Feedback!

Partner: Veranstalter:
Vielen Dank!
Dragan Panjkov

SPKonferenz 2017 - Introducing SDKs for Microsoft Graph

Recommended

More Related Content

What's hot (20)

Similar to SPKonferenz 2017 - Introducing SDKs for Microsoft Graph (20)

More from Dragan Panjkov (20)

Recently uploaded (20)

SPKonferenz 2017 - Introducing SDKs for Microsoft Graph

Editor's Notes