Table of Contents

Analytics.Read

Allows the app to read the signed-in user's activity statistics, such as how much time the user has spent on emails, in meetings, or in chat sessions.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the Analytics.Read permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category Application Delegated
Identifier - e03cf23f-8056-446a-8994-7d93dfc8b50e
DisplayText - Read user activity statistics
Description - Allows the app to read the signed-in user's activity statistics, such as how much time the user has spent on emails, in meetings, or in chat sessions.
AdminConsentRequired Yes No

Graph Methods

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: activityStatistics

Property Type Description
activity analyticsActivityType The type of activity for which statistics are returned. The possible values are: call, chat, email, focus, and meeting.
duration Duration Total hours spent on the activity. The value is represented in ISO 8601 format for durations.
endDate Date Date when the activity ended, expressed in ISO 8601 format for calendar dates. For example, the property value could be "2019-07-03" that follows the YYYY-MM-DD format.
id String Read-only ID for the activity. Do not parse or customize the value for your scenarios.
startDate Date Date when the activity started, expressed in ISO 8601 format for calendar dates. For example, the property value could be "2019-07-04" that follows the YYYY-MM-DD format.
timeZoneUsed String The time zone that the user sets in Microsoft Outlook is used for the computation. For example, the property value could be "Pacific Standard Time."