Microsoft Teams 的班次

对于经理，规划班次计划，将打开和未填充的班次广播到你的团队。对于团队成员，可以轻松查看班次并发出计划更改请求（交换/套餐/休假）。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	标准	除以下各项外的所有 Power Automate 区域： - 由世纪互联运营的中国云
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 中国区域
Power Apps	标准	除以下各项外的所有 Power Apps 区域： - 由世纪互联运营的中国云
Power Automate	标准	除以下各项外的所有 Power Automate 区域： - 由世纪互联运营的中国云

联系人
Name	Microsoft
URL	https://support.microsoft.com/teams

连接器元数据
发布者	Microsoft
网站	https://docs.microsoft.com/en-us/microsoftteams/expand-teams-across-your-org/shifts-for-teams-landing-page
隐私策略	https://privacy.microsoft.com/privacystatement
类别	生产力

Microsoft Teams 中的班次是一种计划管理工具，可帮助你创建、更新和管理团队的计划。

Shifts + Power Automate 使你可以从 Shifts 获取信息，并与其他应用创建自定义工作流，并大规模执行作。无需编写任何代码，自动执行关键进程。

触发器的已知问题和限制

GCC 区域中不支持触发器。

正在创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

列出团队中的所有 Open Shift 请求	此作返回计划中的所有 Open Shift 更改请求。
列出团队中的所有交换班次请求	此作返回计划中的所有交换班次请求。
列出团队中的所有产品/服务班次请求	此作返回计划中的所有产品/服务班次请求。
列出团队中的所有休假原因	此作返回与团队关联的超时原因列表。
列出团队中的所有休假实例	此作返回计划中的所有超时实例
列出团队中的所有休假请求	此作返回计划中的所有超时请求。
列出团队中的所有开放班次	此作将返回团队中的所有 Open Shifts。
列出团队中的所有班次	此作返回分配给团队成员的所有班次
列出团队中的所有计划组	此作返回计划中的所有计划组。
列出我的团队的所有休息时间	此作返回所有团队的人员离开的时间。
列出我的团队的所有开放班次	此作返回需要从所有团队填充的 Open Shifts。
列出来自我的团队的所有班次	此作将返回所有团队分配的班次。
创建新的 Shift	此作将创建新的 Shift 并将其分配给团队成员
创建新的休假实例	此作将创建一个新的休假实例，并将其分配给团队成员
创建新的打开 Shift	在计划中创建新的打开班次。
删除 Shift	此作使用 Shift 的唯一 ID 删除 Shift。
删除打开的 Shift	此作将删除 Open Shift。
删除超时实例	此作使用其唯一 ID 删除超时。
批准 Open Shift 请求	此作允许管理员批准 Open Shift 请求。
批准交换班次请求	此作允许用户批准交换班次请求。
批准产品/服务转移请求	此作允许收件人/经理批准产品/服务转移请求。
批准休假请求	此作允许管理员批准休假请求。
拒绝 Open Shift 请求	此作允许经理拒绝 Open Shift 请求。
拒绝交换班次请求	此作允许用户拒绝交换班次请求。
拒绝产品/服务转移请求	此作允许用户拒绝产品/服务转移请求。
拒绝休假请求	此作允许管理员拒绝超时请求。
更新打开的 Shift	更新计划中的打开班次。
获取 Open Shift 请求	此作按 ID 返回 Open Shift 更改请求。
获取 Shift	此作使用 Shift 的唯一 ID 返回 Shift 的详细信息。
获取交换班次请求	此作按 ID 返回交换班次请求。
获取产品/服务转移请求	此作按 ID 返回产品/服务转移请求。
获取休假实例	此作使用其唯一 ID 返回超时的详细信息。
获取休假请求	此作按 ID 返回超时请求。
获取打开的 Shift	此作返回 Open Shift 的详细信息。
获取计划的详细信息	此作使用计划的唯一 ID 返回计划的详细信息。
获取计划组	此作使用其唯一 ID 返回计划组的详细信息。

列出团队中的所有 Open Shift 请求

操作 ID:: ListOpenShiftChangeRequests

此作返回计划中的所有 Open Shift 更改请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
页面大小	$top		integer	每页的项（在 .../Settings 下启用分页）
请求状态	state		string	请求状态筛选器

名称	路径	类型	说明
打开 Shift 更改请求列表	value	array of OpenShiftChangeRequestResponse	打开的班次更改请求列表。

列出团队中的所有交换班次请求

操作 ID:: ListSwapShiftsChangeRequests

此作返回计划中的所有交换班次请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
页面大小	$top		integer	每页的项（在 .../Settings 下启用分页）
请求状态	state		string	请求状态筛选器

名称	路径	类型	说明
交换班次更改请求列表	value	array of SwapShiftsChangeRequestResponse	交换班次更改请求的列表。

列出团队中的所有产品/服务班次请求

操作 ID:: ListOfferShiftRequests

此作返回计划中的所有产品/服务班次请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
页面大小	$top		integer	每页的项（在 .../Settings 下启用分页）
请求状态	state		string	请求状态筛选器

名称	路径	类型	说明
产品/服务转移请求列表	value	array of OfferShiftRequestResponse	产品/服务转移请求列表。

列出团队中的所有休假原因

操作 ID:: ListTimeOffReasons

此作返回与团队关联的超时原因列表。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
页面大小	$top		integer	每页的项（在 .../Settings 下启用分页）

休假原因列表。

与团队关联的休假原因列表: GetTimeOffReasonsResponse

列出团队中的所有休假实例

操作 ID:: ListTimesOff

此作返回计划中的所有超时实例

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
从开始时间	startTime		date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endTime		date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
页面大小	$top		integer	每页的项（在 .../Settings 下启用分页）

名称	路径	类型	说明
休假实例列表	value	array of TimeOffResponse	超时实例列表

列出团队中的所有休假请求

操作 ID:: ListTimeOffRequests

此作返回计划中的所有超时请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
页面大小	$top		integer	每页的项（在 .../Settings 下启用分页）
请求状态	state		string	请求状态筛选器

名称	路径	类型	说明
休假请求列表	value	array of TimeOffRequestResponse	休假请求列表。

列出团队中的所有开放班次

操作 ID:: ListOpenShifts

此作将返回团队中的所有 Open Shifts。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
从开始时间	startTime		date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endTime		date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
页面大小	$top		integer	每页的项（在 .../Settings 下启用分页）

名称	路径	类型	说明
打开班次列表	value	array of OpenShiftResponse	打开班次列表

列出团队中的所有班次

操作 ID:: ListShifts

此作返回分配给团队成员的所有班次

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
从开始时间	startTime		date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endTime		date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
页面大小	$top		integer	每页的项（在 .../Settings 下启用分页）

名称	路径	类型	说明
Shifts 列表	value	array of ShiftResponse	班次列表

列出团队中的所有计划组

操作 ID:: ListSchedulingGroups

此作返回计划中的所有计划组。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
页面大小	$top		integer	每页的项（在 .../Settings 下启用分页）

名称	路径	类型	说明
计划组列表	value	array of SchedulingGroupResponse	计划组的列表。

列出我的团队的所有休息时间

操作 ID:: ListTimesOffCrossTeam

此作返回所有团队的人员离开的时间。

参数

名称	密钥	类型	说明
从开始时间	startTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
用户显示名称	assignedToUserName	string	分配给具有名称的用户
页面大小	$top	integer	要提取的次数

名称	路径	类型	说明
关闭列表的时间	value	array of TimeOffResponse	关闭时间列表

列出我的团队的所有开放班次

操作 ID:: ListOpenShiftsCrossTeam

此作返回需要从所有团队填充的 Open Shifts。

参数

名称	密钥	类型	说明
从开始时间	startTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
页面大小	$top	integer	每页的项（在 .../Settings 下启用分页）

名称	路径	类型	说明
打开班次列表	value	array of OpenShiftResponse	打开班次列表

列出来自我的团队的所有班次

操作 ID:: ListShiftsCrossTeam

此作将返回所有团队分配的班次。

参数

名称	密钥	类型	说明
从开始时间	startTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
用户显示名称	assignedToUserName	string	分配给具有名称的用户
页面大小	$top	integer	每页的项（在 .../Settings 下启用分页）

名称	路径	类型	说明
Shifts 列表	value	array of ShiftResponse	班次列表

创建新的 Shift

操作 ID:: CreateShift

此作将创建新的 Shift 并将其分配给团队成员

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
计划组 ID	schedulingGroupId		string	计划组 ID
显示名称	displayName		string	显示名称
注释	notes		string	Shift 备注
开始时间	startDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme	True	string	主题颜色。
付费	isPaid		boolean	付费
开始时间	startDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
Code	code		string	Code
显示名称	displayName		string	显示名称
用户 ID	userId	True	string	分配给用户 ID

Shift 实体。

转变: ShiftResponse

创建新的休假实例

操作 ID:: CreateTimeOff

此作将创建一个新的休假实例，并将其分配给团队成员

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
休假原因	timeOffReasonId	True	string	休假原因 ID
开始时间	startDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme	True	string	主题颜色。
用户 ID	userId	True	string	分配给用户 ID

休假实体。

休假: TimeOffResponse

创建新的打开 Shift

操作 ID:: CreateOpenShift

在计划中创建新的打开班次。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
计划组 ID	schedulingGroupId		string	计划组 ID
显示名称	displayName		string	显示名称
注释	notes		string	注释
开始时间	startDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme		string	主题颜色。
打开槽计数	openSlotCount	True	integer	打开槽计数
付费	isPaid		boolean	付费
开始时间	startDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
Code	code		string	Code
显示名称	displayName		string	显示名称

打开 Shift 实体

打开 Shift: OpenShiftResponse

删除 Shift

操作 ID:: DeleteShift

此作使用 Shift 的唯一 ID 删除 Shift。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
Shift ID	shiftId	True	string	Shift 的唯一 ID。

删除打开的 Shift

操作 ID:: DeleteOpenShift

此作将删除 Open Shift。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
打开 Shift ID	openShiftId	True	string	Open Shift 的唯一 ID。

删除超时实例

操作 ID:: DeleteTimeOff

此作使用其唯一 ID 删除超时。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
休假 ID	timeOffId	True	string	休假的唯一 ID。

批准 Open Shift 请求

操作 ID:: OpenShiftChangeRequestApprove

此作允许管理员批准 Open Shift 请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
打开 Shift 更改请求 ID	openShiftChangeRequestId	True	string	请求的唯一 ID
来自管理器的消息	message		string	接受请求时，从经理到发件人/收件人的邮件。

批准交换班次请求

操作 ID:: SwapShiftsChangeRequestApprove

此作允许用户批准交换班次请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
交换班次更改请求 ID	swapShiftsChangeRequestId	True	string	请求的唯一 ID
来自收件人/管理器的邮件	message		string	接受请求时的消息。

批准产品/服务转移请求

操作 ID:: OfferShiftRequestApprove

此作允许收件人/经理批准产品/服务转移请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
产品/服务转移请求 ID	offerShiftRequestId	True	string	产品/服务转移请求的唯一 ID
来自收件人/管理器的邮件	message		string	接受请求时的消息。

批准休假请求

操作 ID:: TimeOffRequestApprove

此作允许管理员批准休假请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
休假请求 ID	timeOffRequestId	True	string	超时请求的唯一 ID
来自管理器的消息	message		string	接受请求时，从经理到发件人/收件人的邮件。

拒绝 Open Shift 请求

操作 ID:: OpenShiftChangeRequestDecline

此作允许经理拒绝 Open Shift 请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
打开 Shift 更改请求 ID	openShiftChangeRequestId	True	string	请求的唯一 ID
来自管理器的消息	message		string	请求被拒绝时，从经理到发件人/收件人的邮件。

拒绝交换班次请求

操作 ID:: SwapShiftsChangeRequestDecline

此作允许用户拒绝交换班次请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
交换班次更改请求 ID	swapShiftsChangeRequestId	True	string	请求的唯一 ID
来自收件人/管理器的邮件	message		string	请求被拒绝时的消息。

拒绝产品/服务转移请求

操作 ID:: OfferShiftRequestDecline

此作允许用户拒绝产品/服务转移请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
产品/服务转移请求 ID	offerShiftRequestId	True	string	产品/服务转移请求的唯一 ID
来自收件人/管理器的邮件	message		string	请求被拒绝时的消息。

拒绝休假请求

操作 ID:: TimeOffRequestDecline

此作允许管理员拒绝超时请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
休假请求 ID	timeOffRequestId	True	string	超时请求的唯一 ID
来自管理器的消息	message		string	请求被拒绝时，从经理到发件人/收件人的邮件。

更新打开的 Shift

操作 ID:: UpdateOpenShift

更新计划中的打开班次。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
打开 Shift ID	openShiftId	True	string	Open Shift 的唯一 ID。
计划组 ID	schedulingGroupId		string	计划组 ID
显示名称	displayName		string	显示名称
注释	notes		string	注释
开始时间	startDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme		string	主题颜色。
打开槽计数	openSlotCount	True	integer	打开槽计数
付费	isPaid		boolean	付费
开始时间	startDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	True	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
Code	code		string	Code
显示名称	displayName		string	显示名称

打开 Shift 实体

打开 Shift: OpenShiftResponse

获取 Open Shift 请求

操作 ID:: GetOpenShiftChangeRequest

此作按 ID 返回 Open Shift 更改请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
打开 Shift 更改请求 ID	openShiftChangeRequestId	True	string	请求的唯一 ID

打开 Shift 更改请求实体

打开班次更改请求: OpenShiftChangeRequestResponse

获取 Shift

操作 ID:: GetShift

此作使用 Shift 的唯一 ID 返回 Shift 的详细信息。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
Shift ID	shiftId	True	string	Shift 的唯一 ID。

Shift 实体。

转变: ShiftResponse

获取交换班次请求

操作 ID:: GetSwapShiftsChangeRequest

此作按 ID 返回交换班次请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
交换班次更改请求 ID	swapShiftsChangeRequestId	True	string	请求的唯一 ID

交换 Shift 请求实体

交换班次请求: SwapShiftsChangeRequestResponse

获取产品/服务转移请求

操作 ID:: GetOfferShiftRequest

此作按 ID 返回产品/服务转移请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
产品/服务转移请求 ID	offerShiftRequestId	True	string	产品/服务转移请求的唯一 ID

产品/服务转移请求实体

产品/服务转移请求: OfferShiftRequestResponse

获取休假实例

操作 ID:: GetTimeOff

此作使用其唯一 ID 返回超时的详细信息。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
休假 ID	timeOffId	True	string	休假的唯一 ID。

休假实体。

休假: TimeOffResponse

获取休假请求

操作 ID:: GetTimeOffShiftRequest

此作按 ID 返回超时请求。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
休假请求 ID	timeOffRequestId	True	string	超时请求的唯一 ID

休假请求实体

休息时间请求: TimeOffRequestResponse

获取打开的 Shift

操作 ID:: GetOpenShift

此作返回 Open Shift 的详细信息。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
打开 Shift ID	openShiftId	True	string	Open Shift 的唯一 ID。

打开 Shift 实体

打开 Shift: OpenShiftResponse

获取计划的详细信息

操作 ID:: GetSchedule

此作使用计划的唯一 ID 返回计划的详细信息。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID

计划实体。

Body: ScheduleResponse

获取计划组

操作 ID:: GetSchedulingGroup

此作使用其唯一 ID 返回计划组的详细信息。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID
计划组 ID	schedulingGroupId	True	string	计划组的唯一 ID。

计划组实体

计划组: SchedulingGroupResponse

触发器

创建 Open Shift 请求时，更新或删除	此作在创建、更新或删除 Open Shift 请求时触发。
创建 Shift 时，更新或删除	此作在创建、更新或删除 Shift 时触发。
创建、更新或删除交换班次请求时	此作在创建、更新或删除交换班次请求时触发。
创建、更新或删除产品/服务转移请求时	此作在创建、更新或删除产品/服务转移请求时触发。
创建休假请求时，更新或删除	此作在创建、更新或删除超时请求时触发。

创建 Open Shift 请求时，更新或删除

操作 ID:: TriggerForOpenShiftChangeRequests

此作在创建、更新或删除 Open Shift 请求时触发。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID

包含订阅元数据和数据后端的有效负载

Body: WebhookPushResponse

创建 Shift 时，更新或删除

操作 ID:: TriggerForShifts

此作在创建、更新或删除 Shift 时触发。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID

包含订阅元数据和数据后端的有效负载

Body: WebhookPushResponse

创建、更新或删除交换班次请求时

操作 ID:: TriggerForSwapShiftsChangeRequests

此作在创建、更新或删除交换班次请求时触发。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID

包含订阅元数据和数据后端的有效负载

Body: WebhookPushResponse

创建、更新或删除产品/服务转移请求时

操作 ID:: TriggerForOfferShiftRequests

此作在创建、更新或删除产品/服务转移请求时触发。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID

包含订阅元数据和数据后端的有效负载

Body: WebhookPushResponse

创建休假请求时，更新或删除

操作 ID:: TriggerForTimeOffRequests

此作在创建、更新或删除超时请求时触发。

参数

名称	密钥	必需	类型	说明
团队	teamId	True	string	添加团队 ID

包含订阅元数据和数据后端的有效负载

Body: WebhookPushResponse

定义

WebhookPushResponse

包含订阅元数据和数据后端的有效负载

名称	路径	类型	说明
value	value	array of WebhookNotificationEntity	值列表

WebhookNotificationEntity

名称	路径	类型	说明
更改类型	changeType	string	资源更改类型（已创建/更新/删除）。
resourceData	resourceData	WebhookPushResponseResourceEntity

WebhookPushResponseResourceEntity

名称	路径	类型	说明
资源标识符	id	string	更新的资源的 ID。
团队 ID	teamId	string	发生更新的团队的 ID。

ScheduleResponse

计划实体。

名称	路径	类型	说明
计划 ID	id	string	计划的唯一 ID。
计划时区	timeZone	string	计划的时区。
计划预配状态	provisionStatus	string	计划的预配状态。
计划预配状态代码	provisionStatusCode	string	计划的预配状态代码。

TimeOffResponse

休假实体。

名称	路径	类型	说明
ID	id	string	休假的唯一 ID。
创建日期时间	createdDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
修改日期时间	lastModifiedDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
分配给用户 ID	userId	string	分配给用户 ID。
用户信息	userInfo	UserInfo	用户信息
团队信息	teamInfo	TeamInfo	团队信息
	sharedTimeOff	SharedTimeOff	休假的共享版本。
草稿更改>	draftTimeOff	DraftTimeOff	休假的初步版本

SharedTimeOff

休假的共享版本。

名称	路径	类型	说明
休假原因 ID	timeOffReasonId	string	休假原因 ID。
开始时间	startDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme	Theme	主题颜色。

DraftTimeOff

休假的初步版本

名称	路径	类型	说明
休假原因 ID	timeOffReasonId	string	休假原因 ID。
开始时间	startDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme	Theme	主题颜色。

ShiftResponse

Shift 实体。

名称	路径	类型	说明
ID	id	string	Shift 的唯一 ID。
创建日期时间	createdDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
修改日期时间	lastModifiedDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
分配给用户 ID	userId	string	分配给用户 ID。
计划组 ID	schedulingGroupId	string	计划组 ID。
计划组信息	schedulingGroupInfo	SchedulingGroupInfo	计划组信息
用户信息	userInfo	UserInfo	用户信息
团队信息	teamInfo	TeamInfo	团队信息
	sharedShift	SharedShift	Shift 的共享版本。
草稿更改>	draftShift	DraftShift	Shift 的初步版本

SharedShift

Shift 的共享版本。

名称	路径	类型	说明
显示名称	displayName	string	显示名称
注释	notes	string	Shift 备注
开始时间	startDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme	Theme	主题颜色。
Activities	activities	Activities	Shift 活动

DraftShift

Shift 的初步版本

名称	路径	类型	说明
显示名称	displayName	string	显示名称
注释	notes	string	注释
开始时间	startDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme	Theme	主题颜色。
Activities	activities	Activities	Shift 活动

主题

主题颜色。

主题: string

Activities

Shift 活动

名称	路径	类型	说明
付费	isPaid	boolean	付费
开始时间	startDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
Code	code	string	Code
显示名称	displayName	string	显示名称

ScheduleGroupResponse

计划组实体

名称	路径	类型	说明
ID	id	string	计划组的唯一 ID。
显示名称	displayName	string	计划组的显示名称。
处于活动状态	isActive	boolean	指示在创建新实体或更新现有实体时是否可以使用计划组。
用户 ID	userIds	array of string	计划组中用户的 ID 列表。

ScheduleGroupInfo

计划组信息

名称	路径	类型	说明
计划组 ID	schedulingGroupId	string	计划组的唯一 ID。
显示名称	displayName	string	计划组的显示名称。
Code	code	string	计划组代码。

用户信息

名称	路径	类型	说明
用户 ID	userId	string	用户的 ID。
显示名称	displayName	string	用户的显示名称。

TeamInfo

团队信息

名称	路径	类型	说明
团队 ID	teamId	string	团队的 ID。
显示名称	displayName	string	团队的显示名称。

OpenShiftResponse

打开 Shift 实体

名称	路径	类型	说明
ID	id	string	Open Shift 的唯一 ID。
创建日期时间	createdDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
修改日期时间	lastModifiedDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
计划组 ID	schedulingGroupId	string	计划组 ID
计划组信息	schedulingGroupInfo	SchedulingGroupInfo	计划组信息
团队信息	teamInfo	TeamInfo	团队信息
	sharedOpenShift	SharedOpenShift	Open Shift 的共享版本
草稿更改>	draftOpenShift	DraftOpenShift	Open Shift 的初步版本

SharedOpenShift

Open Shift 的共享版本

名称	路径	类型	说明
显示名称	displayName	string	显示名称
注释	notes	string	注释
开始时间	startDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme	Theme	主题颜色。
打开槽计数	openSlotCount	integer	打开槽计数
Activities	activities	Activities	Shift 活动

DraftOpenShift

Open Shift 的初步版本

名称	路径	类型	说明
显示名称	displayName	string	显示名称
注释	notes	string	注释
开始时间	startDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
结束时间	endDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
主题	theme	Theme	主题颜色。
打开槽计数	openSlotCount	integer	打开槽计数
Activities	activities	Activities	Shift 活动

GetTimeOffReasonsResponse

休假原因列表。

名称	路径	类型	说明
包含休假原因的数组	value	array of object	休假原因列表。
休假原因 ID	value.id	string	超时原因的唯一 ID。
创建时间	value.createdDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
修改日期时间	value.lastModifiedDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
显示名称	value.displayName	string	显示名称
图标类型	value.iconType	string	图标类型
处于活动状态	value.isActive	boolean	处于活动状态

TimeOffRequestResponse

休假请求实体

名称	路径	类型	说明
ID	id	string	超时请求的唯一 ID。
创建时间	createdDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
修改时间	lastModifiedDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
分配到	assignedTo	string	请求分配到的人员：“manager”或“recipient”
State	state	string	“approved”、“pending”或“declined”
发送方时间	senderDateTime	date-time	发送请求的时间
发件人消息	senderMessage	string	来自请求发件人的邮件
发件人 ID	senderUserId	string	发送请求的用户的 ID
管理器作时间	managerActionDateTime	date-time	经理响应的时间
管理器消息	managerActionMessage	string	来自经理的消息
管理器 ID	managerUserId	string	响应的经理的 ID
开始时间	startDateTime	date-time	请求关闭的时间开始时间
结束时间	endDateTime	date-time	请求关闭的时间结束时间
休假原因 ID	timeOffReasonId	string	休假原因的 ID

OfferShiftRequestResponse

产品/服务转移请求实体

名称	路径	类型	说明
ID	id	string	产品/服务转移请求的唯一 ID。
创建时间	createdDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
修改时间	lastModifiedDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
分配到	assignedTo	string	请求分配到的人员：“manager”或“recipient”
State	state	string	“approved”、“pending”或“declined”
发送方时间	senderDateTime	date-time	发送请求的时间
发件人消息	senderMessage	string	来自请求发件人的邮件
发件人 ID	senderUserId	string	发送请求的用户的 ID
发件人 Shift ID	senderShiftId	string	发件人的 Shift ID
接收方时间	recipientActionDateTime	date-time	收件人响应的时间
收件人邮件	recipientActionMessage	string	来自收件人的邮件
收件人 ID	recipientUserId	string	请求收件人的 ID
管理器作时间	managerActionDateTime	date-time	经理响应的时间
管理器消息	managerActionMessage	string	来自经理的消息
管理器 ID	managerUserId	string	响应的经理的 ID

SwapShiftsChangeRequestResponse

交换 Shift 请求实体

名称	路径	类型	说明
ID	id	string	交换 Shift 请求的唯一 ID。
创建时间	createdDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
修改时间	lastModifiedDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
分配到	assignedTo	string	请求分配到的人员：“manager”或“recipient”
State	state	string	“approved”、“pending”或“declined”
发送方时间	senderDateTime	date-time	发送请求的时间
发件人消息	senderMessage	string	来自请求发件人的邮件
发件人 ID	senderUserId	string	发送请求的用户的 ID
发件人 Shift ID	senderShiftId	string	发件人的 Shift ID
接收方时间	recipientActionDateTime	date-time	收件人响应的时间
收件人邮件	recipientActionMessage	string	来自收件人的邮件
收件人 ID	recipientUserId	string	请求收件人的 ID
收件人班次 ID	recipientShiftId	string	来自收件人的 Shift 的 ID
管理器作时间	managerActionDateTime	date-time	经理响应的时间
管理器消息	managerActionMessage	string	来自经理的消息
管理器 ID	managerUserId	string	响应的经理的 ID

OpenShiftChangeRequestResponse

打开 Shift 更改请求实体

名称	路径	类型	说明
ID	id	string	Open Shift Change 请求的唯一 ID。
创建时间	createdDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
修改时间	lastModifiedDateTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC 格式）
分配到	assignedTo	string	请求分配到的人员：“manager”或“recipient”
State	state	string	“approved”、“pending”或“declined”
发送方时间	senderDateTime	date-time	发送请求的时间
发件人消息	senderMessage	string	来自请求发件人的邮件
发件人 ID	senderUserId	string	发送请求的用户的 ID
管理器作时间	managerActionDateTime	date-time	经理响应的时间
管理器消息	managerActionMessage	string	来自经理的消息
管理器 ID	managerUserId	string	响应的经理的 ID
打开 Shift ID	openShiftId	string	所请求的 Open Shift 的 ID

通过

Microsoft Teams 的班次

触发器的已知问题和限制

正在创建连接

违约

限制

操作

列出团队中的所有 Open Shift 请求

参数

返回

列出团队中的所有交换班次请求

参数

返回

列出团队中的所有产品/服务班次请求

参数

返回

列出团队中的所有休假原因

参数

返回

列出团队中的所有休假实例

参数

返回

列出团队中的所有休假请求

参数

返回

列出团队中的所有开放班次

参数

返回

列出团队中的所有班次

参数

返回

列出团队中的所有计划组

参数

返回

列出我的团队的所有休息时间

参数

返回

列出我的团队的所有开放班次

参数

返回

列出来自我的团队的所有班次

参数

返回

创建新的 Shift

参数

返回

创建新的休假实例

参数

返回

创建新的打开 Shift

参数

返回

删除 Shift

参数

删除打开的 Shift

参数

删除超时实例

参数

批准 Open Shift 请求

参数

批准交换班次请求

参数

批准产品/服务转移请求

参数

批准休假请求

参数

拒绝 Open Shift 请求

参数

拒绝交换班次请求

参数

拒绝产品/服务转移请求

参数

拒绝休假请求

参数

更新打开的 Shift

参数

返回

获取 Open Shift 请求

参数

返回