聊天资源类型

命名空间:microsoft.graph

聊天是一个或多个参与者之间的 chatMessage 的 集合。 参与者可以是用户或应用。

注意:如果聊天与 onlineMeeting 实例相关联,则列出的某些方法将可传递地影响会议。

方法

方法 返回类型 说明
聊天管理
创建聊天 聊天 创建新聊天。
获取聊天 聊天 读取聊天的属性和关系。
更新聊天 聊天 更新聊天的属性。
删除聊天 None 删除聊天。
列出聊天成员 conversationMember 集合 获取聊天中所有用户的列表。
添加聊天成员 位置标头 将用户添加到聊天。
获取聊天成员 conversationMember 获取聊天中的单个用户。
删除聊天成员 从聊天中删除用户。
获取用户和应用之间的聊天 聊天 在用户和应用之间获取一对一聊天
邮件
在聊天中列出消息 chatMessage 在聊天中获取消息。
获取聊天中的消息 chatMessage 获取聊天中的单个消息。
为用户在所有聊天中获取消息 聊天 集合 从用户参与的所有聊天中获取消息。
应用
列出聊天中的应用 teamsAppInstallation 集合 列出聊天 (和关联的会议) 中安装的应用。
在聊天中获取应用 teamsAppInstallation 获取在聊天 (和关联的会议) 中安装的特定应用。
在聊天中添加应用 在聊天 (和关联的会议) 中添加) 应用 (安装。
在聊天中升级应用 None 更新到聊天 (和关联的会议) 中安装的最新版本的应用。
从聊天中卸载应用 None 从聊天 (和关联的会议) 中删除 (卸载) 应用。
List permission grants resourceSpecificPermissionGrant 集合 列出在此聊天中授予的应用的权限。
选项卡
在聊天中列出选项卡 teamsTab 列出固定到聊天 (和关联的会议) 的选项卡。
聊天中的“获取”选项卡 teamsTab 获取固定到聊天 (和关联的会议) 的特定选项卡。
“添加”选项卡以聊天 teamsTab 将 (固定) 选项卡添加到聊天 (和关联的会议) 。
聊天中的“更新”选项卡 teamsTab 更新聊天 (和关联的会议) 中选项卡的属性。
从聊天中删除选项卡 None 从聊天 (和关联的会议) 中删除 (取消固定) 选项卡。
固定的消息
列出固定的消息 pinnedChatMessageInfo 集合 获取聊天中已固定消息的列表。
固定消息 pinnedChatMessageInfo 在聊天中固定聊天消息。
取消固定邮件 None 从聊天中取消固定消息。

注意: 使用应用程序权限时,请确保知道如何获取聊天 ID。 由于不支持使用应用程序权限列出聊天,因此并非所有方案都可行。 可以获取具有委派权限的聊天 ID,以及从具有应用程序权限 的 /chats/getAllMessages 的更改通知 获取聊天 ID。

属性

属性 类型 说明
chatType chatType 指定聊天类型。 可取值为:grouponeOnOnemeetingunknownFutureValue
createdDateTime dateTimeOffset 创建聊天的日期和时间。 只读。
id String 聊天的唯一标识符。 此为只读属性。
lastUpdatedDateTime dateTimeOffset 聊天重命名或上次更改成员列表的日期和时间。 此为只读属性。
onlineMeetingInfo teamworkOnlineMeetingInfo 表示有关联机会议的详细信息。 如果聊天未与联机会议关联,则 属性为空。 此为只读属性。
tenantId String 在其中创建聊天的租户的标识符。 此为只读属性。
topic String (聊天的可选) 主题或主题。 仅适用于群组聊天。
观点 chatViewpoint 表示有关聊天的调用方特定信息,例如最后一条消息读取日期和时间。 仅当在委托上下文中发出请求时,才会填充此属性。
webUrl String Microsoft Teams 中聊天的 URL。 应将 URL 视为不透明的 Blob,并且不进行分析。 此为只读属性。

chatType 值

成员 说明
oneOnOne 0 指示聊天是一对一聊天。 此类型的聊天的名单大小是固定的;无法删除/添加成员。
1 指示聊天是群组聊天。 可针对此类聊天更新至少两人的名单大小 () 。 稍后可以删除/添加成员。
会议 2 指示聊天与联机会议相关联。 此类聊天仅在创建联机会议过程中创建。
unknownFutureValue 3 可演变枚举 sentinel 值。 请勿使用。

关系

关系 类型 说明
installedApps teamsAppInstallation 集合 聊天中所有应用的集合。 可为 NULL。
lastMessagePreview chatMessageInfo 在聊天中发送的最后一条消息的预览。 如果未在聊天中发送任何消息,则为 Null。 目前,只有 列表聊天 操作支持此属性。
members conversationMember 集合 聊天中所有成员的集合。 可为 Null。
messages chatMessage 集合 聊天中所有消息的集合。 可为 NULL。
permissionGrants resourceSpecificPermissionGrant 集合 授予应用聊天权限的集合。
pinnedMessages pinnedChatMessageInfo 集合 聊天中所有固定消息的集合。 可为 NULL。
选项卡 teamsTab 集合 聊天中所有选项卡的集合。 可为 Null。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "createdDateTime": "dateTimeOffset",
  "chatType": "string",
  "id": "string (identifier)",
  "lastUpdatedDateTime": "dateTimeOffset",
  "onlineMeetingInfo": {
    "@odata.type": "microsoft.graph.teamworkOnlineMeetingInfo"
  },
  "tenantId": "string",
  "topic": "string",
  
  "viewpoint": {
    "@odata.type": "microsoft.graph.chatViewpoint"
  },
  "webUrl": "string",
}