SPKonferenz 2017 - Introducing SDKs for Microsoft Graph
Download as PPTX, PDF0 likes550 views
The document introduces SDKs for Microsoft Graph, highlighting its unique APIs, unified endpoint, and open authentication model. It describes how to use Microsoft Graph SDKs in .NET and JavaScript, with examples of managing resources like emails and files in OneDrive. Various links to resources and demos are provided for further exploration and development using the Microsoft Graph API.
![client
.api('/me/people')
.select(["displayName", "department", "title"])
.get((err, res) => {
console.log(res)
})](https://image.slidesharecdn.com/spkonferenz2017draganpanjkovintroducingmsgraphsdks-170428102855/85/SPKonferenz-2017-Introducing-SDKs-for-Microsoft-Graph-22-320.jpg)
![// 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)
})](https://image.slidesharecdn.com/spkonferenz2017draganpanjkovintroducingmsgraphsdks-170428102855/85/SPKonferenz-2017-Introducing-SDKs-for-Microsoft-Graph-23-320.jpg)
![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!");
});](https://image.slidesharecdn.com/spkonferenz2017draganpanjkovintroducingmsgraphsdks-170428102855/85/SPKonferenz-2017-Introducing-SDKs-for-Microsoft-Graph-25-320.jpg)
SPKonferenz 2017 - Introducing SDKs for Microsoft Graph
- 1. Partner: Veranstalter: Introducing SDKs for Microsoft Graph Dragan Panjkov
- 2. Dragan Panjkov Microsoft MVP – Office Servers and Services Consultant at K2 NE (www.k2.com) Website and blog: www.dragan-panjkov.com Twitter: @panjkov
- 3. Microsoft Graph API Microsoft Graph SDK for .NET Microsoft Graph SDK for JavaScript
- 4. A unique set of API to rule all the services Unified endpoint Unique handshake and Access Token Unique development experience Unique consumption model: REST
- 5. 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
- 7. Demo Playing with the Microsoft Graph API
- 10. 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)
- 11. 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!
- 12. Demo “Hello World!” Microsoft Graph SDK
- 13. 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
- 14. Replicates OData behavior and signatures Select() => $select Filter() => $filter OrderBy() => $orderby Expand() => $expand Provides paging capabilities Through NextPageRequest property on query results/collections
- 15. Demo Request and Query Model
- 16. Collections provide methods to manage resources AddAsync() => POST UpdateAsync() => PATCH PutAsync() => PUT DeleteAsync() => DELETE
- 17. Reference exception type ServiceException Useful properties Error (Code, Message, InnerError, AdditionalData, etc.) IsMatch() method for fine handling of errors
- 19. 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>
- 20. var client = MicrosoftGraph.Client.init({ authProvider: (done) => { done(null, "PassInAccessTokenHere"); //first parameter takes an error if you can't get an access token } });
- 21. // 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(", ")); });
- 22. client .api('/me/people') .select(["displayName", "department", "title"]) .get((err, res) => { console.log(res) })
- 23. // construct the email object const mail = { subject: "Microsoft Graph JavaScript Sample", toRecipients: [{ emailAddress: { address: "[email protected]" } }], 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) })
- 24. // 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) })
- 25. 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!"); });
- 26. // 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); });
- 27. 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); });
- 30. FRAGEN?
- 31. Ich freue mich auf Ihr Feedback!
- 32. Partner: Veranstalter: Vielen Dank! Dragan Panjkov