ConversationActivityClient 类
用于管理 Teams 对话中的活动的客户端。
初始化会话活动客户端。
构造函数
ConversationActivityClient(service_url: str, http_client: Client | None = None, api_client_settings: ApiClientSettings | None = None)参数
| 名称 | 说明 |
|---|---|
|
service_url
必需
|
Teams 服务的基 URL |
|
http_client
|
要使用的可选 HTTP 客户端。 如果未提供，将创建一个新项。 默认值: None
|
|
api_client_settings
|
可选 API 客户端设置。 默认值: None
|
方法
| create |
在对话中创建一个新活动。 |
| create_targeted |
在对话中创建新的目标活动。 目标活动仅对指定的收件人可见。 Warning Preview 此 API 处于预览状态，将来可能会更改。 诊断：ExperimentalTeamsTargeted |
| delete |
从对话中删除活动。 |
| delete_targeted |
从对话中删除目标活动。 Warning Preview 此 API 处于预览状态，将来可能会更改。 诊断：ExperimentalTeamsTargeted |
| get_members |
获取与活动关联的成员。 |
| reply |
回复对话中的活动。 |
| update |
更新对话中的现有活动。 |
| update_targeted |
更新对话中的现有目标活动。 Warning Preview 此 API 处于预览状态，将来可能会更改。 诊断：ExperimentalTeamsTargeted |
create
在对话中创建一个新活动。
async create(conversation_id: str, activity: MessageActivityInput | MessageReactionActivityInput | TypingActivityInput) -> SentActivity参数
| 名称 | 说明 |
|---|---|
|
conversation_id
必需
|
对话的 ID |
|
activity
必需
|
要创建的活动 |
返回
| 类型 | 说明 |
|---|---|
|
已创建的活动 |
create_targeted
在对话中创建新的目标活动。
目标活动仅对指定的收件人可见。
Warning
Preview
此 API 处于预览状态，将来可能会更改。
诊断：ExperimentalTeamsTargeted
async create_targeted(conversation_id: str, activity: MessageActivityInput | MessageReactionActivityInput | TypingActivityInput) -> SentActivity参数
| 名称 | 说明 |
|---|---|
|
conversation_id
必需
|
对话的 ID |
|
activity
必需
|
要创建的活动 |
返回
| 类型 | 说明 |
|---|---|
|
已创建的活动 |
delete
从对话中删除活动。
async delete(conversation_id: str, activity_id: str) -> None参数
| 名称 | 说明 |
|---|---|
|
conversation_id
必需
|
对话的 ID |
|
activity_id
必需
|
要删除的活动的 ID |
delete_targeted
从对话中删除目标活动。
Warning
Preview
此 API 处于预览状态，将来可能会更改。
诊断：ExperimentalTeamsTargeted
async delete_targeted(conversation_id: str, activity_id: str) -> None参数
| 名称 | 说明 |
|---|---|
|
conversation_id
必需
|
对话的 ID |
|
activity_id
必需
|
要删除的活动的 ID |
get_members
获取与活动关联的成员。
async get_members(conversation_id: str, activity_id: str) -> List[TeamsChannelAccount]参数
| 名称 | 说明 |
|---|---|
|
conversation_id
必需
|
对话的 ID |
|
activity_id
必需
|
活动的 ID |
返回
| 类型 | 说明 |
|---|---|
|
表示活动成员的 TeamsChannelAccount 对象列表 |
reply
回复对话中的活动。
async reply(conversation_id: str, activity_id: str, activity: MessageActivityInput | MessageReactionActivityInput | TypingActivityInput) -> SentActivity参数
| 名称 | 说明 |
|---|---|
|
conversation_id
必需
|
对话的 ID |
|
activity_id
必需
|
要答复的活动的 ID |
|
activity
必需
|
回复活动 |
返回
| 类型 | 说明 |
|---|---|
|
创建的回复活动 |
update
更新对话中的现有活动。
async update(conversation_id: str, activity_id: str, activity: MessageActivityInput | MessageReactionActivityInput | TypingActivityInput) -> SentActivity参数
| 名称 | 说明 |
|---|---|
|
conversation_id
必需
|
对话的 ID |
|
activity_id
必需
|
要更新的活动的 ID |
|
activity
必需
|
更新的活动数据 |
返回
| 类型 | 说明 |
|---|---|
|
更新的活动 |
update_targeted
更新对话中的现有目标活动。
Warning
Preview
此 API 处于预览状态，将来可能会更改。
诊断：ExperimentalTeamsTargeted
async update_targeted(conversation_id: str, activity_id: str, activity: MessageActivityInput | MessageReactionActivityInput | TypingActivityInput) -> SentActivity参数
| 名称 | 说明 |
|---|---|
|
conversation_id
必需
|
对话的 ID |
|
activity_id
必需
|
要更新的活动的 ID |
|
activity
必需
|
更新的活动数据 |
返回
| 类型 | 说明 |
|---|---|
|
更新的活动 |