serviceUpdateMessage 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示有关服务中更改的公告。
表示产品中的重大更新、新功能等公告;例如，新 SharePoint 功能的发布。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 获取邮件 | serviceUpdateMessage | 检索 serviceUpdateMessage 对象的属性和关系。 |
| 标记读取状态 | 布尔值 | 将 serviceUpdateMessage列表标记为已登录用户的 已读 。 |
| 标记未读状态 | 布尔值 | 将 serviceUpdateMessage列表标记为已登录用户的 未读 。 |
| 存档状态 | 布尔值 | 存档已登录用户的 serviceUpdateMessage列表。 |
| 未存档状态 | 布尔值 | 取消存档已登录用户的 serviceUpdateMessage列表。 |
| 标记收藏夹状态 | 布尔值 | 将 serviceUpdateMessage列表的状态更改为已登录用户的收藏夹。 |
| 删除收藏夹状态 | 布尔值 | 删除已登录用户的 serviceUpdateMessage的收藏夹状态。 |
| 列出邮件附件 | serviceAnnouncementAttachment 集合 | 获取与服务消息关联的附件列表。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| actionRequiredByDateTime | DateTimeOffset | 消息操作的预期截止时间。 |
| attachmentsArchive | Stream | 邮件的所有附件的 zip 文件。 |
| body | itemBody | 服务消息正文的内容类型和内容。 contentType 属性 html支持的值为 。 |
| “类别” | serviceUpdateCategory | 服务消息类别。 可能的值是：preventOrFixIssue、planForChange、stayInformed、unknownFutureValue。 |
| 详细信息 | 集合 (keyValuePair) | 有关服务消息的其他详细信息。 此属性不支持筛选器。 继承自 serviceAnnouncementBase。 |
| endDateTime | DateTimeOffset | 服务消息的结束时间。 继承自 serviceAnnouncementBase。 |
| hasAttachments | Boolean | 指示邮件是否具有任何附件。 |
| id | String | 服务消息的 ID。 继承自 serviceAnnouncementBase。 |
| isMajorChange | 布尔值 | 指示消息是否描述服务的主要更新。 |
| lastModifiedDateTime | DateTimeOffset | 服务消息的上次修改时间。 继承自 serviceAnnouncementBase。 |
| 服务业 | 集合 (字符串) | 服务消息的受影响服务。 |
| severity | serviceUpdateSeverity | 服务消息的严重性。 可取值为：normal、high、critical、unknownFutureValue。 |
| startDateTime | DateTimeOffset | 服务消息的开始时间。 继承自 serviceAnnouncementBase。 |
| tags | 集合 (字符串) | 服务消息的标记集合。 标记由发布消息的服务团队/支持团队提供，告知此消息是否包含隐私数据，或者此消息是否用于服务新功能更新，等等。 |
| title | String | 服务消息的标题。 继承自 serviceAnnouncementBase。 |
| 观点 | serviceUpdateMessageViewpoint | 表示服务消息的用户视点数据。 此数据包括消息状态，例如用户是否已存档、阅读或将邮件标记为收藏夹。 使用应用程序权限访问此属性时，此属性为 null。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| attachments | 集合 (服务AnnouncementAttachment) | serviceAnnouncementAttachments 的集合。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.serviceUpdateMessage",
"startDateTime": "String (timestamp)",
"endDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"title": "String",
"details": [
{
"@odata.type": "microsoft.graph.keyValuePair"
}
],
"id": "String (identifier)",
"body": {
"@odata.type": "microsoft.graph.itemBody"
},
"category": "String",
"severity": "String",
"tags": [
"String"
],
"isMajorChange": "Boolean",
"actionRequiredByDateTime": "String (timestamp)",
"services": [
"String"
],
"viewPoint": {
"@odata.type": "microsoft.graph.serviceUpdateMessageViewpoint"
},
"hasAttachments": "Boolean",
"attachmentsArchive": "Stream"
}