com.microsoft.connecteddevices.userdata.usernotifications

The UserNotifications namespace contains APIs that allow an app to receive and manage user-targeted notifications published by your app server via Microsoft Graph Notifications to enable human-centric, cross-device notification experiences.

**Important**: This namespace is not yet available to 3rd-party app developers. If you'd like to be put on a waiting list to get early access, email us at ProjectRomeTeam@microsoft.com.

Classes

UserNotification

This class represents a single user notification instance. A user notification is created and published by your app server targeted at a user, distributed to all device endpoints of the same logged in user.

UserNotificationChannel

This class provides the notification change reader which handles the receiving and management of user notifications for the application.

UserNotificationReader

This class provides new incoming user notifications and user notification updates. It also provides access to the collection of user notifications persisted in the Connected Device Platform.

UserNotificationReaderDataChangedEventArgs

EventArgs class for when the data in the UserNotificationReader changes

UserNotificationReaderOptions

This class allows the app to provide options on the notification reader, such as only receiving new user notifications and not existing notification updates.

UserNotificationUpdateResult

This class provides the success and failure status for attempts to update a notification’s state.

Enums

UserNotificationPriority

Contains values that describe the priority of a notification.

UserNotificationReaderStartPosition

Contains values that determines the position where any new change in the reader starts – new incoming user notification or new incoming state updates.

UserNotificationReadState

Contains values that determines the read state of each UserNotification. Notifications can be marked as Read or Unread by the app. The app gets to define the corresponding user experience.

UserNotificationReadStateFilter

Contains values that indicates a read state filter when creating a notification reader. This determines whether the app wants to receive all notifications, only read ones, or only unread ones.

UserNotificationStatus

Contains values that determines whether the notification is deleted or not. Deleted notifications will still be in the notification store and be returned by the reader before the platform cleanup happens. A corresponding reader filter *UserNotificationStatusFilter* can be applied to prevent these notifications from showing up in notification reader.

UserNotificationStatusFilter

Contains values that indicates a status filter when creating a notification reader. This determines whether the app wants to receive all notifications, only active ones, or only deleted ones.

UserNotificationUserActionState

Contains values that determines the user action state of each UserNotification. Notifications can be marked as Activated, Dismissed, or Snoozed by the app. The app gets to define the corresponding user experience.

UserNotificationUserActionStateFilter

Contains values that indicates a user action state filter when creating a notification reader. This determines whether the app wants to receive all notifications, dismissed ones only, activated ones only, or etc.