Working with Office 365 usage reports in Microsoft Graph

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

With Microsoft Graph, you can access Office 365 usage reports resources to get the information about how people in your business are using Office 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who may not need an Office 365 license at all.

Authorization

Microsoft Graph controls access to resources via permissions. You must specify the permissions you need in order to access Reports resources. Typically, you specify permissions in the Azure Active Directory (Azure AD) portal. For more information, see Microsoft Graph permissions reference and Reports permissions.

Changes to the Reports APIs

The original Reports APIs have been updated so you can call the API for the specific view you want instead of passing a view parameter. We recommend that you start using the new APIs in your applications as soon as possible. The following table lists the APIs that were removed and the new APIs that replaced them.

Original API New API
EmailActivity
EmailAppUsage
MailboxUsage
Office365Activations
Office365ActiveUser
Office365GroupsActivity
OneDriveActivity
OneDriveUsage
SharePointActivity
SharePointSiteUsage
SfbActivity
SfbDeviceUsage
SfbOrganizerActivity
SfbParticipantActivity
SfbP2PActivity
YammerActivity
YammerDeviceUsage
YammerGroupsActivity

Next steps

Reports resources and APIs can open up new ways for you to engage with users and manage their experiences with Microsoft Graph. To learn more:

  • Drill down on the methods and properties of the resources most helpful to your scenario.
  • Try the API in the Graph Explorer.

Need more ideas? See how some of our partners are using Microsoft Graph.