反馈 编辑

获取 chatMessageHostedContent

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

检索 chatMessageHostedContent 对象的属性和 关系。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

频道权限

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） ChannelMessage.Read.All、Group.Read.All 、Group.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 ChannelMessage.Read.Group、ChannelMessage.Read.All、Group.Read.All 、Group.ReadWrite.All

注意：标记为 ** 的权限仅支持向后兼容。 建议您更新解决方案以使用上表中列出的备用权限，并避免今后使用这些权限。

聊天权限

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） Chat.Read、Chat.ReadWrite
委派（个人 Microsoft 帐户） 不支持。
应用程序 ChatMessage.Read.Chat、Chat.Read.All、Chat.ReadWrite.All

注意：ChannelMessage.Read.Group 和 ChatMessage.Read.Chat 权限使用 特定于资源的许可。

备注

在使用应用程序权限调用此 API 之前，你必须先请求访问权限。 有关详细信息，请参阅 Microsoft Teams 中的受保护 API。

HTTP 请求

获取频道消息中的托管内容

GET /teams/{team-id}/channels/{channel-id}/messages/{message-id}/hostedContents/{hosted-content-id}
GET /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies/{reply-id}/hostedContents/{hosted-content-id}

获取聊天消息中的托管内容

GET /chats/{chat-id}/messages/{message-id}/hostedContents/{hosted-content-id}
GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id}/hostedContents/{hosted-content-id}

可选的查询参数

此操作不支持使用 OData 查询参数来自定义响应。

请求标头

名称 说明
Authorization Bearer {code}

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法在响应 200 OK 正文中返回 响应代码和请求的 chatMessageHostedContent 对象。

示例

示例 1：获取聊天中消息的托管内容

请求

下面展示了示例请求。

GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages/1615971548136/hostedContents/aWQ9eF8wLXd1cy1kOS1lNTRmNjM1NWYxYmJkNGQ3ZTNmNGJhZmU4NTI5MTBmNix0eXBlPTEsdXJsPWh0dHBzOi8vdXMtYXBpLmFzbS5za3lwZS5jb20vdjEvb2JqZWN0cy8wLXd1cy1kOS1lNTRmNjM1NWYxYmJkNGQ3ZTNmNGJhZmU4NTI5MTBmNi92aWV3cy9pbWdv

响应

下面展示了示例响应。

注意： contentBytes 和 contentType 始终设置为 null。

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3A2da4c29f6d7041eca70b638b43d45437%40thread.v2')/messages('1615971548136')/hostedContents/$entity",
    "id": "aWQ9eF8wLXd1cy1kOS1lNTRmNjM1NWYxYmJkNGQ3ZTNmNGJhZmU4NTI5MTBmNix0eXBlPTEsdXJsPWh0dHBzOi8vdXMtYXBpLmFzbS5za3lwZS5jb20vdjEvb2JqZWN0cy8wLXd1cy1kOS1lNTRmNjM1NWYxYmJkNGQ3ZTNmNGJhZmU4NTI5MTBmNi92aWV3cy9pbWdv",
    "contentBytes": null,
    "contentType": null
}

示例 2：获取图像的托管内容字节

请求

GET https://graph.microsoft.com/beta/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages/1615971548136/hostedContents/aWQ9eF8wLXd1cy1kOS1lNTRmNjM1NWYxYmJkNGQ3ZTNmNGJhZmU4NTI5MTBmNix0eXBlPTEsdXJsPWh0dHBzOi8vdXMtYXBpLmFzbS5za3lwZS5jb20vdjEvb2JqZWN0cy8wLXd1cy1kOS1lNTRmNjM1NWYxYmJkNGQ3ZTNmNGJhZmU4NTI5MTBmNi92aWV3cy9pbWdv/$value

响应

响应包含正文中托管内容的字节。 content-type header 指定托管内容类型。

HTTP/1.1 200 OK
Content-type: image/jpeg

{
  "id": "id-value"
}