Microsoft Teams 的班次

對於經理來說，規劃輪班時間表，向您的團隊廣播開放和未填補的班次。對於團隊成員，可以輕鬆查看您的班次並提出時間表更改請求（交換/報價/休假）。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	標準	除下列區域外的所有 Power Automate 區域： - 由 21Vianet 營運的中國雲
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure 中國區域
Power Apps	標準	除下列區域外的所有 Power Apps 區域： - 由 21Vianet 營運的中國雲
Power Automate（自動化服務）	標準	除下列區域外的所有 Power Automate 區域： - 由 21Vianet 營運的中國雲

連絡人
名稱	Microsoft
URL	https://support.microsoft.com/teams

連接器中繼資料
Publisher	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 變更要求。
列出團隊中的所有交換班次請求	此作業會傳回排程中的所有交換班次要求。
列出團隊中的所有排程群組	此作業會傳回排程中的所有排程群組。
列出團隊中的所有班次	此作業會傳回指派給小組成員的所有班次
列出團隊中的所有空缺輪班	此作業會傳回團隊中的所有開放班次。
列出團隊中的所有請假原因	此作業會傳回與小組相關聯的請假原因清單。
列出團隊中的所有請假實例	此作業會傳回排程中的所有請假執行個體
列出團隊中的所有請假申請	此作業會傳回排程中的所有請假請求。
列出團隊中的所有選件轉移請求	此作業會傳回排程中的所有選件班次請求。
列出我團隊的所有班次	此作業會傳回所有小組指派的班次。
列出我團隊的所有空缺輪班	此作業會傳回需要從所有小組填補的空缺班次。
列出我的團隊的所有休息時間	此作業會傳回人員離開所有小組的時間。
刪除 Time Off 執行個體	此作業會使用其唯一 ID 刪除休假。
刪除班次	此作業會使用班次的唯一識別碼刪除班次。
刪除空缺班次	此作業會刪除「開啟班次」。
取得 Open Shift 請求	此作業會依識別碼傳回 Open Shift 變更要求。
取得交換班次要求	此作業會依識別碼傳回交換班次要求。
取得優惠轉移要求	此作業會依ID傳回選件轉移請求。
取得排程群組	此作業會使用排程群組的唯一識別碼傳回詳細資料。
取得時間表的詳細資料	此作業會使用排程的唯一識別碼傳回排程的詳細資料。
取得請假執行個體	此作業會使用其唯一 ID 傳回休假的詳細資料。
取得請假申請	此作業會依識別碼傳回休假請求。
建立新的 Open Shift	在排程中建立新的空缺班次。
建立新的 Time Off 執行個體	此作業會建立新的「請假」執行個體，並將其指派給小組成員
建立新的班次	此作業會建立新的班次，並將其指派給小組成員
拒絕 Open Shift 請求	此作業可讓經理拒絕 Open Shift 要求。
拒絕交換班次請求	此操作允許用戶拒絕交換班次請求。
拒絕優惠班次請求	此作業可讓使用者拒絕優惠方案轉移請求。
拒絕請假申請	此作業可讓經理拒絕請假要求。
更新空缺班次	更新排程中的空缺輪班。
核准交換班次要求	此作業可讓使用者核准交換班次要求。
核准優惠班次請求	此作業可讓收件者/管理員核准優惠方案班次請求。
核准請假申請	此作業可讓經理核准請假申請。
核准開放班次請求	此作業可讓經理核准「開放輪班」要求。
獲得開放輪班	此作業會傳回 Open Shift 的詳細資料。
輪班	此作業會使用班次的唯一 ID 傳回班次的詳細資料。

列出團隊中的所有 Open Shift 請求

作業識別碼：: ListOpenShiftChangeRequests

此作業會傳回排程中的所有 Open Shift 變更要求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
頁面大小	$top		integer	每頁項目數（在 .../設定下啟用分頁）
請求狀態	state		string	要求狀態篩選

傳回

名稱	路徑	類型	Description
開啟班次變更要求清單	value	array of OpenShiftChangeRequestResponse	開放輪班變更請求清單。

列出團隊中的所有交換班次請求

作業識別碼：: ListSwapShiftsChangeRequests

此作業會傳回排程中的所有交換班次要求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
頁面大小	$top		integer	每頁項目數（在 .../設定下啟用分頁）
請求狀態	state		string	要求狀態篩選

傳回

名稱	路徑	類型	Description
交換班次變更要求清單	value	array of SwapShiftsChangeRequestResponse	交換班次變更請求清單。

列出團隊中的所有排程群組

作業識別碼：: ListSchedulingGroups

此作業會傳回排程中的所有排程群組。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
頁面大小	$top		integer	每頁項目數（在 .../設定下啟用分頁）

傳回

名稱	路徑	類型	Description
排程群組清單	value	array of SchedulingGroupResponse	排程群組清單。

列出團隊中的所有班次

作業識別碼：: ListShifts

此作業會傳回指派給小組成員的所有班次

參數

名稱	機碼	必要	類型	Description
球隊	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	每頁項目數（在 .../設定下啟用分頁）

傳回

名稱	路徑	類型	Description
班次清單	value	array of ShiftResponse	班次列表

列出團隊中的所有空缺輪班

作業識別碼：: ListOpenShifts

此作業會傳回團隊中的所有開放班次。

參數

名稱	機碼	必要	類型	Description
球隊	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	每頁項目數（在 .../設定下啟用分頁）

傳回

名稱	路徑	類型	Description
開啟班次清單	value	array of OpenShiftResponse	空缺班次列表

列出團隊中的所有請假原因

作業識別碼：: ListTimeOffReasons

此作業會傳回與小組相關聯的請假原因清單。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
頁面大小	$top		integer	每頁項目數（在 .../設定下啟用分頁）

傳回

休假原因清單。

與團隊相關聯的請假原因清單: GetTimeOffReasonsResponse

列出團隊中的所有請假實例

作業識別碼：: ListTimesOff

此作業會傳回排程中的所有請假執行個體

參數

名稱	機碼	必要	類型	Description
球隊	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	每頁項目數（在 .../設定下啟用分頁）

傳回

名稱	路徑	類型	Description
請假實例清單	value	array of TimeOffResponse	請假執行個體清單

列出團隊中的所有請假申請

作業識別碼：: ListTimeOffRequests

此作業會傳回排程中的所有請假請求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
頁面大小	$top		integer	每頁項目數（在 .../設定下啟用分頁）
請求狀態	state		string	要求狀態篩選

傳回

名稱	路徑	類型	Description
請假申請清單	value	array of TimeOffRequestResponse	請假請求清單。

列出團隊中的所有選件轉移請求

作業識別碼：: ListOfferShiftRequests

此作業會傳回排程中的所有選件班次請求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
頁面大小	$top		integer	每頁項目數（在 .../設定下啟用分頁）
請求狀態	state		string	要求狀態篩選

傳回

名稱	路徑	類型	Description
優惠班次要求清單	value	array of OfferShiftRequestResponse	選件班次請求清單。

列出我團隊的所有班次

作業識別碼：: ListShiftsCrossTeam

此作業會傳回所有小組指派的班次。

參數

名稱	機碼	類型	Description
從開始時間開始	startTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間	endTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
使用者顯示名稱	assignedToUserName	string	指派給名稱為
頁面大小	$top	integer	每頁項目數（在 .../設定下啟用分頁）

傳回

名稱	路徑	類型	Description
班次清單	value	array of ShiftResponse	班次列表

列出我團隊的所有空缺輪班

作業識別碼：: ListOpenShiftsCrossTeam

此作業會傳回需要從所有小組填補的空缺班次。

參數

名稱	機碼	類型	Description
從開始時間開始	startTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間	endTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
頁面大小	$top	integer	每頁項目數（在 .../設定下啟用分頁）

傳回

名稱	路徑	類型	Description
開啟班次清單	value	array of OpenShiftResponse	空缺班次列表

列出我的團隊的所有休息時間

作業識別碼：: ListTimesOffCrossTeam

此作業會傳回人員離開所有小組的時間。

參數

名稱	機碼	類型	Description
從開始時間開始	startTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間	endTime	date-time	yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
使用者顯示名稱	assignedToUserName	string	指派給名稱為
頁面大小	$top	integer	要取多少次

傳回

名稱	路徑	類型	Description
不在清單上的時間	value	array of TimeOffResponse	休息時間列表

刪除 Time Off 執行個體

作業識別碼：: DeleteTimeOff

此作業會使用其唯一 ID 刪除休假。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
請假 ID	timeOffId	True	string	請假的唯一識別碼。

刪除班次

作業識別碼：: DeleteShift

此作業會使用班次的唯一識別碼刪除班次。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
班次識別碼	shiftId	True	string	班次的唯一 ID。

刪除空缺班次

作業識別碼：: DeleteOpenShift

此作業會刪除「開啟班次」。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
開啟班次 ID	openShiftId	True	string	開放輪班的唯一 ID。

取得 Open Shift 請求

作業識別碼：: GetOpenShiftChangeRequest

此作業會依識別碼傳回 Open Shift 變更要求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
開啟班次變更要求 ID	openShiftChangeRequestId	True	string	要求的唯一ID

傳回

開啟班次變更要求實體

開放班次變更請求: OpenShiftChangeRequestResponse

取得交換班次要求

作業識別碼：: GetSwapShiftsChangeRequest

此作業會依識別碼傳回交換班次要求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
交換班次變更要求識別碼	swapShiftsChangeRequestId	True	string	要求的唯一ID

傳回

交換班次要求實體

交換班次請求: SwapShiftsChangeRequestResponse

取得優惠轉移要求

作業識別碼：: GetOfferShiftRequest

此作業會依ID傳回選件轉移請求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
優惠班次要求識別碼	offerShiftRequestId	True	string	選件班次請求的唯一ID

傳回

優惠班次要求實體

優惠班次請求: OfferShiftRequestResponse

取得排程群組

作業識別碼：: GetSchedulingGroup

此作業會使用排程群組的唯一識別碼傳回詳細資料。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
排程群組 ID	schedulingGroupId	True	string	排程群組的唯一識別碼。

傳回

排程群組實體

排程群組: SchedulingGroupResponse

取得時間表的詳細資料

作業識別碼：: GetSchedule

此作業會使用排程的唯一識別碼傳回排程的詳細資料。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID

傳回

排程實體。

身體: ScheduleResponse

取得請假執行個體

作業識別碼：: GetTimeOff

此作業會使用其唯一 ID 傳回休假的詳細資料。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
請假 ID	timeOffId	True	string	請假的唯一識別碼。

傳回

休假實體。

休假: TimeOffResponse

取得請假申請

作業識別碼：: GetTimeOffShiftRequest

此作業會依識別碼傳回休假請求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
請假申請 ID	timeOffRequestId	True	string	請假請求的唯一 ID

傳回

請假申請實體

休假要求: TimeOffRequestResponse

建立新的 Open Shift

作業識別碼：: CreateOpenShift

在排程中建立新的空缺班次。

參數

名稱	機碼	必要	類型	Description
球隊	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	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	顯示名稱

傳回

開啟班次實體

開放班次: OpenShiftResponse

建立新的 Time Off 執行個體

作業識別碼：: CreateTimeOff

此作業會建立新的「請假」執行個體，並將其指派給小組成員

參數

名稱	機碼	必要	類型	Description
球隊	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	theme	True	string	主題顏色。
使用者識別碼	userId	True	string	指派給使用者 ID

傳回

休假實體。

休假: TimeOffResponse

建立新的班次

作業識別碼：: CreateShift

此作業會建立新的班次，並將其指派給小組成員

參數

名稱	機碼	必要	類型	Description
球隊	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	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	顯示名稱
使用者識別碼	userId	True	string	指派給使用者 ID

傳回

轉移實體。

轉變: ShiftResponse

拒絕 Open Shift 請求

作業識別碼：: OpenShiftChangeRequestDecline

此作業可讓經理拒絕 Open Shift 要求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
開啟班次變更要求 ID	openShiftChangeRequestId	True	string	要求的唯一ID
經理留言	message		string	當請求被拒絕時，管理員向寄件者/收件者發送的訊息。

拒絕交換班次請求

作業識別碼：: SwapShiftsChangeRequestDecline

此操作允許用戶拒絕交換班次請求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
交換班次變更要求識別碼	swapShiftsChangeRequestId	True	string	要求的唯一ID
收件人/經理的訊息	message		string	拒絕要求時的訊息。

拒絕優惠班次請求

作業識別碼：: OfferShiftRequestDecline

此作業可讓使用者拒絕優惠方案轉移請求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
優惠班次要求識別碼	offerShiftRequestId	True	string	選件班次請求的唯一ID
收件人/經理的訊息	message		string	拒絕要求時的訊息。

拒絕請假申請

作業識別碼：: TimeOffRequestDecline

此作業可讓經理拒絕請假要求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
請假申請 ID	timeOffRequestId	True	string	請假請求的唯一 ID
經理留言	message		string	當請求被拒絕時，管理員向寄件者/收件者發送的訊息。

更新空缺班次

作業識別碼：: UpdateOpenShift

更新排程中的空缺輪班。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
開啟班次 ID	openShiftId	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	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	顯示名稱

傳回

開啟班次實體

開放班次: OpenShiftResponse

核准交換班次要求

作業識別碼：: SwapShiftsChangeRequestApprove

此作業可讓使用者核准交換班次要求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
交換班次變更要求識別碼	swapShiftsChangeRequestId	True	string	要求的唯一ID
收件人/經理的訊息	message		string	接受要求時的訊息。

核准優惠班次請求

作業識別碼：: OfferShiftRequestApprove

此作業可讓收件者/管理員核准優惠方案班次請求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
優惠班次要求識別碼	offerShiftRequestId	True	string	選件班次請求的唯一ID
收件人/經理的訊息	message		string	接受要求時的訊息。

核准請假申請

作業識別碼：: TimeOffRequestApprove

此作業可讓經理核准請假申請。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
請假申請 ID	timeOffRequestId	True	string	請假請求的唯一 ID
經理留言	message		string	接受請求時，管理員向寄件者/收件者發送的訊息。

核准開放班次請求

作業識別碼：: OpenShiftChangeRequestApprove

此作業可讓經理核准「開放輪班」要求。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
開啟班次變更要求 ID	openShiftChangeRequestId	True	string	要求的唯一ID
經理留言	message		string	接受請求時，管理員向寄件者/收件者發送的訊息。

獲得開放輪班

作業識別碼：: GetOpenShift

此作業會傳回 Open Shift 的詳細資料。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
開啟班次 ID	openShiftId	True	string	開放輪班的唯一 ID。

傳回

開啟班次實體

開放班次: OpenShiftResponse

輪班

作業識別碼：: GetShift

此作業會使用班次的唯一 ID 傳回班次的詳細資料。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID
班次識別碼	shiftId	True	string	班次的唯一 ID。

傳回

轉移實體。

轉變: ShiftResponse

觸發程序

建立、更新或刪除 Open Shift 請求時	當建立、更新或刪除 Open Shift 請求時，會觸發此作業。
建立、更新或刪除交換班次要求時	當建立、更新或刪除交換班次要求時，會觸發此作業。
建立、更新或刪除班次時	此作業會在建立、更新或刪除班次時觸發。
建立、更新或刪除請假申請時	此作業會在建立、更新或刪除請假請求時觸發。
建立、更新或刪除選件班次請求時	此作業會在建立、更新或刪除選件班次請求時觸發。

建立、更新或刪除 Open Shift 請求時

作業識別碼：: TriggerForOpenShiftChangeRequests

當建立、更新或刪除 Open Shift 請求時，會觸發此作業。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID

傳回

來自後端的承載，其中包含訂閱中繼資料和資料

身體: WebhookPushResponse

建立、更新或刪除交換班次要求時

作業識別碼：: TriggerForSwapShiftsChangeRequests

當建立、更新或刪除交換班次要求時，會觸發此作業。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID

傳回

來自後端的承載，其中包含訂閱中繼資料和資料

身體: WebhookPushResponse

建立、更新或刪除班次時

作業識別碼：: TriggerForShifts

此作業會在建立、更新或刪除班次時觸發。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID

傳回

來自後端的承載，其中包含訂閱中繼資料和資料

身體: WebhookPushResponse

建立、更新或刪除請假申請時

作業識別碼：: TriggerForTimeOffRequests

此作業會在建立、更新或刪除請假請求時觸發。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID

傳回

來自後端的承載，其中包含訂閱中繼資料和資料

身體: WebhookPushResponse

建立、更新或刪除選件班次請求時

作業識別碼：: TriggerForOfferShiftRequests

此作業會在建立、更新或刪除選件班次請求時觸發。

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	新增團隊 ID

傳回

來自後端的承載，其中包含訂閱中繼資料和資料

身體: WebhookPushResponse

定義

WebhookPush回應

來自後端的承載，其中包含訂閱中繼資料和資料

名稱	路徑	類型	Description
value	value	array of WebhookNotificationEntity	值清單

WebhookNotificationEntity

名稱	路徑	類型	Description
變更類型	changeType	string	資源變更類型（已建立/更新/刪除）。
資源數據	resourceData	WebhookPushResponseResourceEntity

WebhookPushResponseResourceEntity

名稱	路徑	類型	Description
資源識別碼	id	string	已更新資源的識別碼。
團隊識別碼	teamId	string	發生更新的小組識別碼。

ScheduleResponse

排程實體。

名稱	路徑	類型	Description
排程 ID	id	string	排程的唯一識別碼。
排程時區	timeZone	string	排程的時區。
排程佈建狀態	provisionStatus	string	明細表的供應狀態。
排程供應狀態碼	provisionStatusCode	string	明細表的供應狀態代碼。

TimeOff回應

休假實體。

名稱	路徑	類型	Description
ID	id	string	請假的唯一識別碼。
建立日期時間	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	休假的初步版本

共享休假

休假的共享版本。

名稱	路徑	類型	Description
請假原因 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	Theme	主題顏色。

草稿休假

休假的初步版本

名稱	路徑	類型	Description
請假原因 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	Theme	主題顏色。

Shift回應

轉移實體。

名稱	路徑	類型	Description
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。
排程群組 ID	schedulingGroupId	string	排程群組 ID。
排程群組資訊	schedulingGroupInfo	SchedulingGroupInfo	排程群組資訊
用戶資訊	userInfo	UserInfo	用戶資訊
團隊資訊	teamInfo	TeamInfo	團隊資訊
	sharedShift	SharedShift	輪班的共享版本。
草稿變更>	draftShift	DraftShift	《輪班》的初步版本

共享班次

輪班的共享版本。

名稱	路徑	類型	Description
顯示名稱	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	Theme	主題顏色。
Activities	activities	Activities	輪班活動

草稿轉移

《輪班》的初步版本

名稱	路徑	類型	Description
顯示名稱	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	Theme	主題顏色。
Activities	activities	Activities	輪班活動

Theme

主題顏色。

Theme: string

Activities

輪班活動

名稱	路徑	類型	Description
已付費	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	顯示名稱

排程群組回應

排程群組實體

名稱	路徑	類型	Description
ID	id	string	排程群組的唯一識別碼。
顯示名稱	displayName	string	排程群組的顯示名稱。
處於活動狀態	isActive	boolean	指出在建立新圖元或更新現有圖元時是否可以使用排程群組。
使用者 ID	userIds	array of string	排程群組中使用者的 ID 清單。

排程群組資訊

名稱	路徑	類型	Description
排程群組識別碼	schedulingGroupId	string	排程群組的唯一識別碼。
顯示名稱	displayName	string	排程群組的顯示名稱。
Code	code	string	排程群組代碼。

UserInfo

用戶資訊

名稱	路徑	類型	Description
使用者識別碼	userId	string	使用者的 ID。
顯示名稱	displayName	string	使用者的顯示名稱。

團隊資訊

名稱	路徑	類型	Description
團隊 ID	teamId	string	小組的識別碼。
顯示名稱	displayName	string	小組的顯示名稱。

OpenShift回應

開啟班次實體

名稱	路徑	類型	Description
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	schedulingGroupId	string	排程群組 ID
排程群組資訊	schedulingGroupInfo	SchedulingGroupInfo	排程群組資訊
團隊資訊	teamInfo	TeamInfo	團隊資訊
	sharedOpenShift	SharedOpenShift	開放輪班的共享版本
草稿變更>	draftOpenShift	DraftOpenShift	開放輪班的初步版本

共享OpenShift

開放輪班的共享版本

名稱	路徑	類型	Description
顯示名稱	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	Theme	主題顏色。
開放插槽計數	openSlotCount	integer	開放插槽計數
Activities	activities	Activities	輪班活動

草稿OpenShift

開放輪班的初步版本

名稱	路徑	類型	Description
顯示名稱	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	Theme	主題顏色。
開放插槽計數	openSlotCount	integer	開放插槽計數
Activities	activities	Activities	輪班活動

GetTimeOffReasons回應

休假原因清單。

名稱	路徑	類型	Description
包含請假原因的陣列	value	array of object	休假原因清單。
請假原因 ID	value.id	string	請假原因的唯一識別碼。
創建時間	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	處於活動狀態

TimeOffRequest回應

請假申請實體

名稱	路徑	類型	Description
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	請求指派給的人員：「管理員」或「收件者」
State	state	string	「已批准」、「待處理」或「已拒絕」
傳送時間	senderDateTime	date-time	傳送請求的時間
寄件者訊息	senderMessage	string	來自要求寄件者的訊息
寄件者 ID	senderUserId	string	傳送要求之使用者的識別碼
經理行動時間	managerActionDateTime	date-time	經理回應的時間
經理訊息	managerActionMessage	string	經理的留言
管理員 ID	managerUserId	string	回應的管理員識別碼
開始時間	startDateTime	date-time	請求關閉的開始時間
結束時間	endDateTime	date-time	請求關閉時間結束
請假原因 ID	timeOffReasonId	string	請假原因的識別碼

OfferShiftRequest回應

優惠班次要求實體

名稱	路徑	類型	Description
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	請求指派給的人員：「管理員」或「收件者」
State	state	string	「已批准」、「待處理」或「已拒絕」
傳送時間	senderDateTime	date-time	傳送請求的時間
寄件者訊息	senderMessage	string	來自要求寄件者的訊息
寄件者 ID	senderUserId	string	傳送要求之使用者的識別碼
寄件者班次識別碼	senderShiftId	string	寄件者的班次識別碼
接收器時間	recipientActionDateTime	date-time	收件人回覆的時間
收件者訊息	recipientActionMessage	string	來自收件者的訊息
收件者 ID	recipientUserId	string	請求收件者的 ID
經理行動時間	managerActionDateTime	date-time	經理回應的時間
經理訊息	managerActionMessage	string	經理的留言
管理員 ID	managerUserId	string	回應的管理員識別碼

交換班次變更要求回應

交換班次要求實體

名稱	路徑	類型	Description
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	請求指派給的人員：「管理員」或「收件者」
State	state	string	「已批准」、「待處理」或「已拒絕」
傳送時間	senderDateTime	date-time	傳送請求的時間
寄件者訊息	senderMessage	string	來自要求寄件者的訊息
寄件者 ID	senderUserId	string	傳送要求之使用者的識別碼
寄件者班次識別碼	senderShiftId	string	寄件者的班次識別碼
接收器時間	recipientActionDateTime	date-time	收件人回覆的時間
收件者訊息	recipientActionMessage	string	來自收件者的訊息
收件者 ID	recipientUserId	string	請求收件者的 ID
收件者班次識別碼	recipientShiftId	string	收件者的班次識別碼
經理行動時間	managerActionDateTime	date-time	經理回應的時間
經理訊息	managerActionMessage	string	經理的留言
管理員 ID	managerUserId	string	回應的管理員識別碼

OpenShiftChangeRequestResponse

開啟班次變更要求實體

名稱	路徑	類型	Description
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	請求指派給的人員：「管理員」或「收件者」
State	state	string	「已批准」、「待處理」或「已拒絕」
傳送時間	senderDateTime	date-time	傳送請求的時間
寄件者訊息	senderMessage	string	來自要求寄件者的訊息
寄件者 ID	senderUserId	string	傳送要求之使用者的識別碼
經理行動時間	managerActionDateTime	date-time	經理回應的時間
經理訊息	managerActionMessage	string	經理的留言
管理員 ID	managerUserId	string	回應的管理員識別碼
開啟班次 ID	openShiftId	string	所要求的開放班次的 ID

共用方式為

Microsoft Teams 的班次

觸發程式的已知問題和限制

正在建立連線

預設

節流限制

動作

列出團隊中的所有 Open Shift 請求

參數

傳回

列出團隊中的所有交換班次請求

參數

傳回

列出團隊中的所有排程群組

參數

傳回

列出團隊中的所有班次

參數

傳回

列出團隊中的所有空缺輪班

參數

傳回

列出團隊中的所有請假原因

參數

傳回

列出團隊中的所有請假實例

參數

傳回

列出團隊中的所有請假申請

參數

傳回

列出團隊中的所有選件轉移請求

參數

傳回

列出我團隊的所有班次

參數

傳回

列出我團隊的所有空缺輪班

參數

傳回

列出我的團隊的所有休息時間

參數

傳回

刪除 Time Off 執行個體

參數

刪除班次

參數

刪除空缺班次

參數

取得 Open Shift 請求

參數

傳回

取得交換班次要求

參數

傳回

取得優惠轉移要求

參數

傳回

取得排程群組

參數

傳回

取得時間表的詳細資料

參數

傳回

取得請假執行個體

參數

傳回

取得請假申請

參數

傳回

建立新的 Open Shift

參數

傳回

建立新的 Time Off 執行個體

參數

傳回

建立新的班次

參數

傳回

拒絕 Open Shift 請求