大网数据广告活动
Microsoft Graph 接口

Microsoft Teams 资源的更改通知

· 52CE 我爱测

使用 Microsoft Graph API 订阅对 Microsoft Teams 中的资源和资源数据的更改。 了解更改通知类型和有效负载。

使用 Microsoft Graph 更改 Microsoft Teams 资源的通知,可以订阅资源的更改(创建、更新和删除)。 更改通知允许你维护订阅,从而提供低延迟模式。 你还可以在通知中获取资源数据,因此避免调用 API 来获取有效负载。

Note: 订阅可以持续的最长时间为 60 分钟;但是,在调用方有权访问资源之前,可以续订订阅。

更改通知类型

Microsoft Teams 支持两种类型的更改通知:

  • 更改通知以跟踪与租户中的资源相关的所有更改: 例如,你可以订阅租户中任何通道中的消息更改,并在租户中的任何通道中创建、更新或删除消息时收到通知。 这些通知可能具有 许可和付款要求,例如 消息 和 成员身份的更改通知。

  • 更改通知以跟踪特定资源的所有更改: 例如,你可以订阅特定通道中消息的更改,并在该通道中创建、更新或删除消息时收到通知。

有关哪些资源支持哪些类型的更改通知的详细信息,请参阅 Microsoft Graph 更改通知。

支持的资源

下表列出了当前支持的 Microsoft Teams 资源和相应的资源路径。

资源 支持的资源路径 可包含在通知中的资源数据
Teams 频道 对所有团队中频道的更改:/teams/getAllChannels 对特定团队中频道的更改:/teams/{id}/channels 是
Teams 聊天 对租户中任何聊天的更改:/chats 对特定聊天的更改:/chats/{id} 是
Teams chatMessage 对所有团队中所有频道聊天消息更改:/teams/getAllMessages 对特定频道中的聊天消息更改:/teams/{id}/channels/{id}/messages对所有聊天的消息更改:/chats/getAllMessages 对特定聊天中的消息更改:/chats/{id}/messages特定用户在所有聊天中对聊天消息所做的更改是以下内容的一部分:/users/{id}/chats/getAllMessages 是
Teams conversationMember 对特定团队中成员身份的更改:/teams/{id}/members 对特定聊天中成员身份的更改:/chats/{id}/members 对所有聊天中成员身份的更改:/chats/getAllMembers 对特定团队下所有频道中的成员身份的更改:teams/{id}/channels/getAllMembers 是
Teams 团队 对租户中任何团队的更改:/teams 对特定团队的更改:/teams/{id} 是

通知有效负载

根据你的订阅,你可以获取包含或不含资源数据的通知。 通过订阅资源数据,可以在收到通知的同时获取消息有效负载,而无需回调并获取内容。

包含资源数据的通知

对于包含资源数据的通知,负载如下所示。 此有效负载用于对应于聊天消息资源的通知。 实际通知包括 资源 和表示已触发该通知的 resourceData 属性。

{
    "value": [{
        "subscriptionId": "10493aa0-4d29-4df5-bc0c-ef742cc6cd7f",
        "changeType": "created",
        "clientState": "<<--SpecifiedClientState-->>",
        "subscriptionExpirationDateTime": "2021-02-02T10:30:34.9097561-08:00",
        "resource": "chats('19:8ea0e38b-efb3-4757-924a-5f94061cf8c2_97f62344-57dc-409c-88ad-c4af14158ff5@unq.gbl.spaces')/messages('1612289765949')",
        "resourceData": {
            "id": "1612289765949",
            "@odata.type": "#Microsoft.Graph.chatMessage",
            "@odata.id": "chats('19:8ea0e38b-efb3-4757-924a-5f94061cf8c2_97f62344-57dc-409c-88ad-c4af14158ff5@unq.gbl.spaces')/messages('1612289765949')"
        },
        "encryptedContent": {
            "data": "<<--EncryptedContent-->",
            "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
            "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
            "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
        },
        "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }],
    "validationTokens": ["<<--ValidationTokens-->>"]
}

有关如何验证令牌和解密负载的详细信息,请参阅设置包含资源数据的更改通知。

解密的通知负载如下所示。 上一示例的已解密有效负载符合 chatMessage 架构。 该负载类似于 GET 操作返回的负载。

{
  "id": "1612289992105",
  "replyToId": null,
  "etag": "1612289992105",
  "messageType": "message",
  "createdDateTime": "2021-02-02T18:19:52Z",
  "lastModifiedDateTime": "2021-02-02T18:19:52.105Z",
  "lastEditedDateTime": null,
  "deletedDateTime": null,
  "subject": null,
  "summary": null,
  "chatId": "19:8ea0e38b-efb3-4757-924a-5f94061cf8c2_97f62344-57dc-409c-88ad-c4af14158ff5@unq.gbl.spaces",
  "importance": "normal",
  "locale": "en-us",
  "webUrl": null,
  "from": {
    "application": null,
    "device": null,
    "user": {
      "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
      "displayName": "Ramjot Singh",
      "userIdentityType": "aadUser"
    },
    "conversation": null
  },
  "body": {
    "contentType": "text",
    "content": "test"
  },
  "channelIdentity": null,
  "attachments": [],
  "mentions": [],
  "policyViolation": null,
  "reactions": [],
  "replies": [],
  "hostedContents": []
}

不含资源数据的通知

不含资源数据的通知为你提供了足够的信息来进行 GET 调用以获取资源。 订阅不含资源数据的通知不需要加密证书(因为不会发送实际资源数据)。

该负载如下所示。 此负载适用于在频道中发送的消息。

{
  "subscriptionId": "9f9d1ed0-c9cc-42e7-8d80-a7fc4b0cda3c",
  "changeType": "created",
  "tenantId": "<<--TenantForWhichNotificationWasSent-->>",  
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2021-02-02T11:26:41.0537895-08:00",
  "resource": "teams('fbe2bf47-16c8-47cf-b4a5-4b9b187c508b')/channels('19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2')/messages('1612293113399')",
  "resourceData": {
    "id": "1612293113399",
    "@odata.type": "#Microsoft.Graph.chatMessage",
    "@odata.id": "teams('fbe2bf47-16c8-47cf-b4a5-4b9b187c508b')/channels('19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2')/messages('1612293113399')"
  }
}

上面的示例显示了对应于聊天消息资源的通知。 实际通知包括 资源 和表示已触发该通知的 resourceData 属性。 资源 和 @odata.id 属性可用于对 Microsoft Graph 进行调用以获取资源的有效负载。

Note: GET 调用始终返回资源的当前状态。 如果在发送通知和检索资源之间更改了资源,则操作将返回更新的资源。

另请参阅

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 anandab-msft)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。