ServiceMessage.Read.All

Allows the app to read your tenant's service announcement messages on behalf of the signed-in user. Messages may include information about new or changed features.

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 ServiceMessage.Read.All 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	1b620472-6534-4fe6-9df2-4680e8aa28ec	eda39fa6-f8cf-4c3c-a909-432c683e4c9b
DisplayText	Read service messages	Read service announcement messages
Description	Allows the app to read your tenant's service announcement messages, without a signed-in user. Messages may include information about new or changed features.	Allows the app to read your tenant's service announcement messages on behalf of the signed-in user. Messages may include information about new or changed features.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /admin/serviceAnnouncement/messages
	GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}
	GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}/attachments
	GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}/attachments/{serviceAnnouncementAttachmentId}

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /admin/serviceAnnouncement/messages
	GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}
	GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}/attachments
	GET /admin/serviceAnnouncement/messages/{serviceUpdateMessageId}/attachments/{serviceAnnouncementAttachmentId}

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgServiceAnnouncementMessage
	Get-MgServiceAnnouncementMessageAttachmentArchive
	Get-MgServiceAnnouncementMessageAttachmentContent

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaServiceAnnouncementMessage
	Get-MgBetaServiceAnnouncementMessageAttachmentArchive
	Get-MgBetaServiceAnnouncementMessageAttachmentContent

Resources

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

serviceAnnouncementAttachment
serviceUpdateMessage

Graph reference: serviceAnnouncementAttachment

Property	Type	Description
content	Stream	The attachment content.
contentType	String	The content type of the attachment.
id	String	The attachment ID. Inherited from entity.
lastModifiedDateTime	DateTimeOffset	The date and time when the attachment was last modified.
name	String	The attachment name.
size	Int32	The size in bytes of the attachment.

Graph reference: serviceUpdateMessage

Property	Type	Description
actionRequiredByDateTime	DateTimeOffset	The expected deadline of the action for the message.
attachmentsArchive	Stream	The zip file that contains all attachments for a message.
body	itemBody	The content type and content of the service message body. The supported value for the contentType property is `html`.
category	serviceUpdateCategory	The service message category. Possible values are: `preventOrFixIssue`, `planForChange`, `stayInformed`, `unknownFutureValue`.
details	Collection(keyValuePair)	Additional details about service message. This property doesn't support filters. Inherited from serviceAnnouncementBase.
endDateTime	DateTimeOffset	The end time of the service message. Inherited from serviceAnnouncementBase.
hasAttachments	Boolean	Indicates whether the message has any attachment.
id	String	The id of the service message. Inherited from serviceAnnouncementBase.
isMajorChange	Boolean	Indicates whether the message describes a major update for the service.
lastModifiedDateTime	DateTimeOffset	The last modified time of the service message. Inherited from serviceAnnouncementBase.
services	Collection(string)	The affected services by the service message.
severity	serviceUpdateSeverity	The severity of the service message. Possible values are: `normal`, `high`, `critical`, `unknownFutureValue`.
startDateTime	DateTimeOffset	The start time of the service message. Inherited from serviceAnnouncementBase.
tags	Collection(string)	A collection of tags for the service message. Tags are provided by the service team/support team who post the message to tell whether this message contains privacy data, or whether this message is for a service new feature update, and so on.
title	String	The title of the service message. Inherited from serviceAnnouncementBase.
viewPoint	serviceUpdateMessageViewpoint	Represents user viewpoints data of the service message. This data includes message status such as whether the user has archived, read, or marked the message as favorite. This property is null when accessed with application permissions.

Table of Contents

ServiceMessage.Read.All

Graph Methods

Resources