Office 365 APIs for your Applications

Ruhani Arora, Technology Evangelist, Microsoft@infinitydlimit

Build intelligent apps by connecting to Office services

Make your solution part of Office apps

Engage users through conversations

Developer opportunityPlatform opportunities available today

http://dev.office.com/

OpportunityOver 4

trillion emails sent with O365

100+ million downloads of mobile apps

850 million

meetings are created a month

2–3 hours/day

spent in Office apps1.2

billion+ users

470+ PB

of storage

<#><Section title goes here>

Make your solution a native part of Office on every platform

Office add-ins

Built with web standardsOffice.js provides interopHosted centrallyAlmost zero client footprintRuns where Office runsDiscoverable marketplace

Browser Controlor iFrame

With HTML5, JavaScript, CSS

<?xml version="1.0" encoding="UTF-8"?><OfficeApp xsi:type="MailApp"> <Version>1.0.0.0</Version> <ProviderName>Salesforce.com</ProviderName> <DefaultLocale>en-US</DefaultLocale> <DisplayName DefaultValue=“Salesforce" /> <Capabilities> <Capability Name="Mailbox" /> </Capabilities> <DesktopSettings> <SourceLocation DefaultValue=“https://salesforce.com/office" /> <RequestedHeight>300</RequestedHeight> </DesktopSettings> <Permissions>ReadItem</Permissions> <Rule xsi:type="RuleCollection" Mode="Or"> <Rule xsi:type="ItemIs" ItemType="Message"/> <Rule xsi:type="ItemIs" ItemType="Appointment"/> </Rule></OfficeApp>

Web server

1 Extend with add-ins

Office add-insA new way to build extensions for Office

Content add-inAdd-in that runs within a document content with read/write accessExcel, PowerPoint, Access

Contextual mail add-inAdd-in launched contextually from a mail message or appointmentOutlook and Outlook Web Access (OWA)

Add-in commandCommand in the Office UI to launch add-in or perform UI-less operationOutlook and Outlook Web Access (OWA)

Task pane add-inAdd-in that runs beside a document/mail with read/write accessWord, Excel, PowerPoint, Project, Outlook

2 Office add-in samples

Contextual mail add-in

Task pane add-in

Content add-in

Add-in command

• In-browser web editor for building client-side Office add-ins

• Uses Office Online and OneDrive for file storage

• Intellisense for JavaScript and HTML5

• Allows for sharing and exporting

• Doesn’t expose full add-in manifest

Development options Napa

3 Getting started

• First-class development experience with templates

and debugging• Exposes the full add-in

manifest and automated deployment commands

• Allows for web projects containing both client-side

and server-side assets

Development optionsVisual Studio

3 Getting started

• You can use anything that delivers for the web

• Microsoft offering Yeoman generator for skeleton add-in project

• Keep in mind that add-ins need SSL/HTTPS

Development optionsOther

3 Getting started

• Responsive, mobile-first, front-end framework for developers that delivers instant look and feel of Office

• Handles typography, color, icons, animations, responsive grid layouts, and localization

Office UI Fabric

3 Getting started

Build smarter apps by connecting to Office services2

Office 365 connected apps

Building integration with Office 365

Calendar

Microsoft Graph APIs

https://graph.microsoft.com

And more …

PeopleDocuments

Access data and intelligence from the Microsoft cloud

Enabling a consistent development platform

For both commercialand consumer

Notebooks

Office Graph

Groups

Build smarter apps by connecting to Office services

Many different APIs to access dataTwo separate auth stacks

State of the world before Microsoft Graph:

Work and school Personal

World today with Microsoft Graph:

Microsoft Graph (https://graph.microsoft.com/)

Work and school

Personal

Single endpoint for:

1.Accessing data/me, /users, /groups, /messages, /drive, ….

2.Traversing data/drive/items/<id>/lastmodifiedByUser

3.Accessing insights/insights/trending

4.Work/School and Personal

What is Microsoft Graph?

https://graph.microsoft.com/

Demo Delve

userPhoto

departmentmobileaboutMebirthdaytagshireDatethumbnailPhotoaddressjobTitlenamealiaspastProjectsresponsibilitiesschoolsskills

CodeGET https://graph.microsoft.com/v1.0/users/yina@contoso.com

GET https://graph.microsoft.com/v1.0/me

GET https://graph.microsoft.com/v1.0/contoso.com/users/<id>

GET https://graph.microsoft.com/v1.0/contoso.com/users/yina@contoso.com?$select=aboutMe

GET https://graph.microsoft.com/v1.0/me/photo

manager

directReports

GROUPS

memberOf

/users

CodeGET https://graph.microsoft.com/v1.0/me/manager

GET https://graph.microsoft.com/v1.0/contoso.com/users/yina@contoso.com/directReports

GET https://graph.microsoft.com/v1.0/me/memberOf

GET https://graph.microsoft.com/v1.0/users/<id>

GET https://graph.microsoft.com/v1.0/contoso.com/users/<id>/photo

manager

directReports

GROUPS

memberOf

/messages

MESSAGES

CodeGET https://graph.microsoft.com/v1.0/me/messages

GET https://graph.microsoft.com/v1.0/me/messages?$top=5

GET https://graph.microsoft.com/v1.0/me/messages?$top=5&$skip=5&$orderby=DateTimeCreated

GET https://graph.microsoft.com/v1.0/me/messages?$top=5&$select=Subject,Sender&$search="from:alexd@contoso.com"

MESSAGES

manager

directReports

GROUPS

memberOf

/events

MESSAGES

EVENTSUSER

CodeGET https://graph.microsoft.com/v1.0/me/events

GET https://graph.microsoft.com/v1.0/me/events?$top=5

GET https://graph.microsoft.com/v1.0/me/calendarview?startdatetime=2015-04-01t01:00:00z&enddatetime=2015-04-16t23:00:00z

EVENTS

MESSAGES

manager

directReports

GROUPS

memberOf

/drive

EVENTS

Shared with me

modifiedByFILE

createdBy

directReports

USERpubli

CodeGET https://graph.microsoft.com/v1.0/me/drive/root/children

GET https://graph.microsoft.com/v1.0/me/drive/items/<id>

GET https://graph.microsoft.com/v1.0/me/drive/items/<id>/lastModifiedByUser

GET https://graph.microsoft.com/v1.0/mary@contoso.com/drive/root/children

GET https://graph.microsoft.com/v1.0/mary@contoso.com/drive/items/<id>/lastModifiedByUser/manager

directReports

Shared with me

modifiedByFILE

createdBy

directReports

public

EVENTS

MESSAGES

manager

GROUPS

memberOf

/groups

directReports

Shared with me

modifiedByFILE

createdBy

directReports

public

createdBy

CONVERSATIONS

EVENTS

GROUPS

memberOf

GET https://graph.microsoft.com/v1.0/me/memberOf?$/microsoft.graph.group?$filter=groupTypes/any(a:a eq

'unified')

GET https://graph.microsoft.com/v1.0/contoso.com/groups/<id>/members

GET https://graph.microsoft.com/v1.0/contoso.com/groups/<id>/drive/root/children

GET https://graph.microsoft.com/v1.0/contoso.com/groups/<id>/conversations

GET https://graph.microsoft.com/v1.0/contoso.com/groups/<id>/events/<id>/accept

createdBy

CONVERSATIONS

EVENTS

GROUPS

memberOf

directReports

Shared with me

modifiedByFILE

createdBy

directReports

public

EVENTS

MESSAGES

manager

GROUPS

memberOf

/workingWith (preview)

createdBy

CONVERSATIONS

EVENTS

GROUPS

memberOf

workingWith

workingWithUSER

CodeGET https://graph.microsoft.com/beta/me/workingWith

GET https://graph.microsoft.com/beta/contoso.com/users/yina@contoso.com/workingWith

GET https://graph.microsoft.com/beta/contoso.com/users/mary@contoso.com/workingWith

workingWith

createdBy

CONVERSATIONS

EVENTS

GROUPS

memberOf

directReports

Shared with me

modifiedByFILE

createdBy

directReports

public

EVENTS

MESSAGES

manager

GROUPS

memberOf

workingWith

trendingAround

directReports

/trendingAround (preview)

CodeGET https://graph.microsoft.com/beta/me/trendingAround

GET https://graph.microsoft.com/beta/contoso.com/users/yina@contoso.com/trendingAround

GET https://graph.microsoft.com/beta/contoso.com/users/mary@contoso.com/trendingAround

trendingAround

directReports

workingWith

createdBy

CONVERSATIONS

EVENTS

GROUPS

memberOf

directReports

Shared with me

modifiedByFILE

createdBy

directReports

public

EVENTS

MESSAGES

manager

GROUPS

memberOf

/tasks (preview)

GROUPS

memberOf

trendingAround

directReports

CodeGET https://graph.microsoft.com/beta/me/tasks

GET https://graph.microsoft.com/beta/contoso.com/users/yina@contoso.com/tasks

GET https://graph.microsoft.com/beta/contoso.com/groups/<id>/tasks

trendingAround

directReports

workingWith

createdBy

CONVERSATIONS

EVENTS

GROUPS

memberOf

directReports

Shared with me

modifiedByFILE

createdBy

directReports

public

EVENTS

MESSAGES

manager

GROUPS

memberOf

/notes (preview)

NOTESNOTE

GROUPS

memberOf

CodeGET https://graph.microsoft.com/beta/me/notes/notebooks

GET https://graph.microsoft.com/beta/me/notes/pages

GET https://graph.microsoft.com/beta/contoso.com/users/yina@contoso.com/notes/sections

GET https://graph.microsoft.com/beta/contoso.com/groups/<id>/notes/notebooks

manager

memberOf

MESSAGES

workingWith

Shared with me

directReports

createdBy

CONVERSATIONS

createdBy

workingWith

EVENTS

trendingAround

GROUPS

NOTESNOTE

public

modifiedBy

USERtrendingArou

manager

memberOf

MESSAGES

workingWith

Shared with me

directReports

createdBy

CONVERSATIONS

createdBy

workingWith

EVENTS

trendingAround

GROUPS

NOTESNOTE

public

modifiedBy

USERtrendingArou

Data spread across multiple services

Operation Service endpointGET my profile https://graph.microsoft.com/v1.0/meGET my files https://graph.microsoft.com/v1.0/me/drive/root/childrenGET my photo https://graph.microsoft.com/v1.0/me/photo/$valueGET my mail https://graph.microsoft.com/v1.0/me/messagesGET my calendar https://graph.microsoft.com/v1.0/me/calendarGET my manager https://graph.microsoft.com/v1.0/me/managerGET last user to modify file foo.txt

https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser

GET users in my organization https://graph.microsoft.com/v1.0/usersGET group conversations https://graph.microsoft.com/v1.0/groups/<id>/conversationsGET people related to me https://graph.microsoft.com/beta/me/peopleGET my tasks https://graph.microsoft.com/beta/me/tasksGET my notes https://graph.microsoft.com/beta/me/notes/notebooksGET files trending around me https://graph.microsoft.com/beta/me/trendingAround

One endpoint to access it: https://graph.microsoft.com/

Many apps want to sign users in from both Microsoft account and Azure ADNow in preview:Single endpoint, OpenID Connect and OAuth 2.0Single SDKSingle end user sign in experienceSingle app registration experience

Works with Microsoft Graph Single API endpoint, business and consumer data

Authentication

• Sign users in using OpenID Connect Azure AD and Office 365 services Supports MFA and federated user sign-in

• Device apps, web sites, SPAs, and service apps

• Pin apps to Office 365 app launcher from My apps

Single authentication flow for Office 365

Common consent• Single auth flow for

accessing all O365 services

• Admin and end-user consent

• Secure protocol OpenID Connect and OAuth 2.0 No capturing user credentials Fine-grained access scopes Long-term access through refresh tokens

• Client: Active Directory Authentication Library (ADAL) .Net, Windows Store, Windows Phone JavaScript iOS Android Xamarin Cordova Node.js Java

• Server .Net: ASP.Net OWIN middleware for OpenID Connect and OAuth 2.0 Node.js

• More to come

Libraries: http://github.com/AzureAD

update

Announcing Microsoft Graph SDKs

SDKs for Graph v1.0 featuresEasily pluggable auth

ADAL libraries for auth V1.0Preview MSAL library for auth V2.0 (.Net)

Platforms: (GA) (RC)

OSS tools – easily customize from metadatahttps://github.com/microsoftgraph

Demo Graph Explorer

Native mobile apps3

Single authentication flowAcross all Office 365 services“Native” apps and web sitesAdmin and end-user consent

Secure protocolOAuth 2.0 (no capturing user credentials)Fine-grained access scopesSupports MFA and federated user sign-inLong-term access through refresh tokens

Unique considerationsof “Native” Azure AppsInherently multi-tenantNo client/app secret (think about distribution)Leverage a web authentication window/broker (via ADAL)No application-only permissions (can go through proxy service)

1 Intro

Azure AD OAuth in Office 365

Microsoft Graph Mobile SDKs

iOShttps://github.com/OfficeDev/Office-365-SDK-for-iOS

Androidhttps://github.com/OfficeDev/Office-365-SDK-for-Android

CordovaNo SDK needed—Make REST API calls via Jquery

Xamarin/Windows UniversalUse the .NET SDK

1 Intro

Open platform

ADAL Library ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔Office 365 SDK ✔ ✔ ✔ ✔ ✔ ✔ ✔Dev.office.com samples ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔

Azure AD and Office 365 offer Libraries/SDKs, but they are not mandatory as the platform is building on web standards such as OAuth2, REST, and Odata.

2 Connect with Microsoft Graph APIs

People API (preview)

Search and browse for the people who matter mostDynamically ranks people based on communication, collaboration, business relationship signals.Augment search queries with topics discussed in previous communicationsFuzzy matching for misspelled namesProvides a complete view of an individual, combining properties from multiple Office 365 services.

Discover who is relevant to your colleaguesOrganization charts don’t always convey working relationships.Learn who your colleagues interact with most closely.

Host: https://graph.microsoft.com

GET /beta/me/people

GET /beta/me/people?$filter=sources/any(s:s/type eq 'Directory')

GET /beta/me/people?$search="Alek Darou"

GET /beta/me/people?$search="Al topic: merger"

GET /beta/users/yina@contoso.com/people

The OneDrive API gives you access to files from everywhere – personal, business, enterprise

Use the new OneDrive API or Microsoft Graph

OneDrive API Overview

Team Sites

Document Libraries

OneDrive for

Business

OneDrive Consume

CSOM / SP REST API

USERS MAIL CALENDAR TASKSGROUPS

Microsoft Graph API - graph.microsoft.com

OneDrive APIdev.onedrive.com

Find Meeting Times API (preview)

Easily find meeting times

InputAttendees and Meeting DurationLocationConstraint, TimeConstraintMaxCandidates

Returns MeetingTimeCandidate with ‘Confidence’ and ‘Score’

Based on meeting booking history(*)Only for Office 365 work and school accounts

Host: https://graph.microsoft.comPOST /beta/me/findMeetingTimeBody{"attendees": [{

"emailAddress": {"address": “yina@contoso.com"},"type": "Required"}, {"emailAddress": {"address": “gareth@contoso.com"},"type": "Required"

}],"meetingDuration": "PT1H"}

3. NOTIFY2. VALIDATE

Webhooks on the Microsoft Graph

Your App

/subscriptions

outlook.com

graph.microsoft.com

/notifications

1. CREATE

Outlook Apps

Webhooks (now GA)

Subscribe today to changes on Mail, Calendar,Personal contacts, Group conversations

RoadmapOneDrive filesUsers and GroupsPlanner Tasks

Gateway to data and insights in Office365

Use Microsoft Graph to build smart apps Easy traversal of

objects and rich relationships

Web Standards, Open Platform

Secure data access

OAuth2.0OpenID ConnectRESTJSON

• Use Microsoft Graph with SDKs! • Visit http://aka.ms/graphsdks for SDKs

on each platform• Build add-ins today:

https://dev.office.com/getting-started/addins• Check out the generation tools at

https://github.com/Microsoft/VIPR • Continue your education at

Microsoft Virtual Academy online.

Office 365 APIs for your Applications

Technology

Transcript of Office 365 APIs for your Applications

Secure APIs and Protocols to Connect Enterprise Applications to ...

Web Applications & APIs - qualys.com · QUALYS SECURITY CONFERENCE 2018 Dave Ferguson Director, Product Management, WAS Web Applications & APIs The Soft Belly of the Cloud Remi Le

Developing Applications with IBM FileNet P8 APIs · Developing Applications with IBM FileNet P8 APIs December 2009 International Technical Support Organization SG24-7743-00

O365 DEVCamp Los Angeles June 16, 2015 Module 04 Hook into Office 365 APIs

Libraries and APIs - University of Saskatchewan · Libraries and APIs CMPT 281 . Overview •Basics of libraries and APIs •Rich internet applications •Examples ... Google Maps,

Deep Dive into Office 365 APIs for SharePoint Site services

Developing Applications With IBM FileNet P8 APIs

APIS M / APIS 15 / APIS 13 / APIS WR / APIS E - skynet.beusers.skynet.be/am259776/APIS FOLDER.pdf · APIS M / APIS 15 / APIS 13 / APIS WR / APIS E APIS, CARAT, AM- 01, DG- 303 ELAN,

Getting started with Office 365 APIs

Cloud Roadshow. Advanced Web Development with the Office 365 APIs.

Supported Applications and APIs · Supported Applications and APIs • APISpecificationsDownload,page1 ... (SOAP,REST)forthatapplication. ... Cisco Hosted Collaboration Mediation

Serverless Applications with AWS SAM —create …...Serverless Applications with AWS SAM —create auto-scaling web APIs —handle background processes —secure APIs —inspect and

Cloud Roadshow. Getting Started with mobile app development with the Office 365 APIs.

Developer's Guide - OpenAM 10 - ForgeRock BackStageOpenAM client applications. This guide further demonstrates how to use the OpenAM APIs including both APIs for client applications,

Advanced protection for Microsoft 365 applications with ...

Creating Plug-n-Play Applications with Open APIs

Secure APIs For Applications In Microkernel-Based Systems

16974100 Building Applications With Google APIs

TH3 Office 365 REST APIs - Peter Carson TH3 Office 365 REST... · TH3 Office 365 REST APIs Peter Carson. Peter Carson ... – ... to Microsoft SharePoint Online

Getting Started withOffice 365 APIs & Microsoft Graph