ClientContext 类

有关Microsoft Teams中的客户端和会话的运行时信息。

构造函数

ClientContext(app_session_id: str, tenant_id: str, user_id: str, user_name: str, page_id: str, auth_token: str, app_id: str | None = None, team_id: str | None = None, message_id: str | None = None, channel_id: str | None = None, chat_id: str | None = None, meeting_id: str | None = None, sub_page_id: str | None = None, _resolved_conversation_id: str | None = None)

参数

名称	说明
app_session_id 必需
tenant_id 必需
user_id 必需
user_name 必需
page_id 必需
auth_token 必需
app_id	默认值: None
team_id	默认值: None
message_id	默认值: None
channel_id	默认值: None
chat_id	默认值: None
meeting_id	默认值: None
sub_page_id	默认值: None
_resolved_conversation_id	默认值: None

属性

app_id

此 ID 是部署后分配给应用的唯一标识符，对于确保跨主机识别正确的应用实例至关重要。

app_id: str | None = None

app_session_id

当前会话的唯一 ID，用于关联遥测数据。 会话对应于应用的生命周期。 新会话在创建 Web 视图（在 Teams 移动版上）或 iframe（在 Teams 桌面版中）托管应用时开始，并在它被销毁时结束。

app_session_id: str

auth_token

MSAL Entra 令牌。

auth_token: str

channel_id

与内容关联的通道的Microsoft Teams ID。

channel_id: str | None = None

chat_id

与内容关联的聊天的Microsoft Teams ID。

chat_id: str | None = None

conversation_id

与内容关联的会话的Microsoft Teams ID。

meeting_id

在会议上下文中运行时，选项卡使用的会议 ID。

meeting_id: str | None = None

message_id

从中启动此任务模块的父消息的 ID。 这仅在从机器人卡启动的任务模块中可用。

message_id: str | None = None

page_id

此内容指向的页面的开发人员定义的唯一 ID。

page_id: str

sub_page_id

此内容指向的子页的开发人员定义的唯一 ID。 此字段应用于还原到页面内的特定状态，例如滚动到或激活特定内容片段。

sub_page_id: str | None = None

team_id

与内容关联的团队的Microsoft Teams ID。

team_id: str | None = None

tenant_id

从请求身份验证令牌中提取的当前用户的Microsoft Entra租户 ID。

tenant_id: str

user_id

从请求身份验证令牌中提取的当前用户的Microsoft Entra对象 ID。

user_id: str

user_name

从请求身份验证令牌中提取的当前用户的名称。

user_name: str