bookingStaffMember 资源类型

命名空间：microsoft.graph

代表在 bookingBusiness 中提供服务的员工。

员工成员可以是配置 预订业务的 Microsoft 365 租户的一部分，也可以使用来自其他电子邮件提供商的电子邮件服务。

预订约会时，Bookings API 会考虑以下设置来确定员工的可用性：

1. 默认情况下，业务运营时间 (bookingBusiness 实体的 businessHours 属性) 表示员工正式发布。
2. 如果 useBusinessHours 为 false，则员工成员的特定工作时间 (bookingStaffmember 实体的 workingHours 属性) 表示该成员的正式发布。
3. 如果 availabilityIsAffectedByPersonalCalendar 为 true，则 Bookings API 将首先查看 (由 #1 或 #2) 确定的员工成员的正式可用时段，并在员工的个人日历中验证这些时段内的可用性，然后再进行预订。

继承自 bookingStaffMemberBase。

Microsoft Bookings在一个预订日历中最多支持 100 名员工。

方法

方法	返回类型	说明
列出教职员工	bookingStaffMember 集合	获取指定 bookingBusiness 中的 bookingStaffMember 对象列表。
创建 bookingStaff	bookingStaffMember 集合	在指定的 bookingBusiness 中创建新的 bookingStaffMember。
获取 bookingStaffMember	bookingStaffMember	获取指定 bookingBusiness 中 bookingStaffMember 的属性和关系。
更新	无	更新指定 bookingBusiness 中 bookingStaffMember 的属性。
删除	无	删除指定 bookingBusiness 中的教职员工。

属性

属性	类型	说明
availabilityIsAffectedByPersonalCalendar	Boolean	True 表示如果员工成员是 Microsoft 365 用户，则 Bookings API 将在进行预订之前验证该员工在 Microsoft 365 中个人日历中的可用性。
displayName	String	员工成员的姓名，如显示给客户。 必填。
emailAddress	String	工作人员的电子邮件地址。 这可以位于与企业相同的 Microsoft 365 租户中，也可以位于其他电子邮件域中。 如果 sendConfirmationsToOwner 属性在业务计划策略中设置为 true，则可以使用此电子邮件地址。 必需。
id	String	采用 GUID 格式的员工 ID。 只读。
isEmailNotificationEnabled	Boolean	True 指示创建或更改分配给他们的预订时，将通过电子邮件通知员工。
role	bookingStaffRole	员工在业务中的角色。 可取值为：guest、administrator、viewer、externalGuest、unknownFutureValue、scheduler 或 teamMember。 请注意，必须使用 Prefer: include-unknown-enum-members 请求标头从此 可演变枚举中获取以下值： scheduler、 teamMember。 必填。
timeZone	String	工作人员的时区。 有关可能值的列表，请参阅 dateTimeTimeZone。
useBusinessHours	Boolean	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"}]
}