bookingStaffMember 资源类型
命名空间:microsoft.graph
代表在 bookingBusiness 中提供服务的员工。
员工成员可以是配置 预订业务的 Microsoft 365 租户的一部分,也可以使用来自其他电子邮件提供商的电子邮件服务。
预订约会时,Bookings API 会考虑以下设置来确定教职员工的可用性:
- 默认情况下,业务运营时间 (bookingBusiness 实体的 businessHours 属性) 表示员工正式发布。
- 如果 useBusinessHours 为 false,则员工成员的特定工作时间 (bookingStaffmember 实体的 workingHours 属性) 表示该成员的正式发布。
- 如果 availabilityIsAffectedByPersonalCalendar 为 true,则 Bookings API 将首先查看由 #1 或 #2) 确定的员工成员的正式可用时间 (,并在员工的个人日历中验证这些时段内的可用性,然后再进行预订。
Microsoft Bookings在一个预订日历中最多支持 100 名员工。
方法
方法 | 返回类型 | 说明 |
---|---|---|
列出教职员工 | bookingStaffMember 集合 | 获取指定 bookingBusiness 中的 bookingStaffMember 对象列表。 |
创建 bookingStaff | bookingStaffMember 集合 | 在指定的 bookingBusiness 中创建新的 bookingStaffMember。 |
获取 bookingStaffMember | bookingStaffMember | 获取指定 bookingBusiness 中 bookingStaffMember 的属性和关系。 |
更新 | 无 | 更新指定 bookingBusiness 中 bookingStaffMember 的属性。 |
删除 | 无 | 删除指定 bookingBusiness 中的员工。 |
属性
属性 | 类型 | 说明 |
---|---|---|
availabilityIsAffectedByPersonalCalendar | 布尔值 | True 表示如果员工成员是 Microsoft 365 用户,Bookings API 将在进行预订之前验证员工在 Microsoft 365 的个人日历中的可用性。 |
displayName | String | 员工成员的姓名,如显示给客户。 必填。 |
emailAddress | String | 工作人员的电子邮件地址。 这可以位于与企业相同的 Microsoft 365 租户中,也可以位于其他电子邮件域中。 如果在业务的计划策略中 将 sendConfirmationsToOwner 属性设置为 true,则可以使用此电子邮件地址。 必需。 |
id | String | 采用 GUID 格式的员工 ID。 此为只读属性。 |
isEmailNotificationEnabled | 布尔值 | True 指示创建或更改分配给他们的预订时,将通过电子邮件通知员工。 |
role | bookingStaffRole | 员工在业务中的角色。 可取值为:guest 、administrator 、viewer 、externalGuest 、unknownFutureValue 、scheduler 或 teamMember 。 请注意,必须使用 Prefer: include-unknown-enum-members 请求标头从此 可演变枚举中获取以下值: scheduler 、 teamMember 。 必填。 |
timeZone | String | 工作人员的时区。 有关可能值的列表,请参阅 dateTimeTimeZone。 |
useBusinessHours | 布尔值 | True 表示员工成员的可用性在企业的 businessHours 属性中指定。 False 表示可用性由工作人员的 workingHours 属性设置确定。 |
workingHours | bookingWorkHours 集合 | 员工可以预订的一周中每天的小时数范围。 默认情况下,它们初始化为与 业务的 businessHours 属性相同。 |
关系
无。
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"availabilityIsAffectedByPersonalCalendar": "Boolean",
"displayName": "String",
"emailAddress": "String",
"id": "String (identifier)",
"isEmailNotificationEnabled": "Boolean",
"role": {"@odata.type": "microsoft.graph.bookingStaffRole"},
"timeZone": "String",
"useBusinessHours": "Boolean",
"workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}]
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈