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 的属性和关系。
更新	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。 只读。
role	bookingStaffRole	员工在业务中的角色。 可能的值是 guest administrator ：、、 viewer externalGuest 和 unknownFutureValue 。 必需。
timeZone	String	员工员工的时区。 有关可能值的列表，请参阅 dateTimeTimeZone。
useBusinessHours	Boolean	True 表示员工的可用性是业务 businessHours 属性中指定的。 False 表示可用性由员工的 workingHours 属性设置确定。
workingHours	bookingWorkHours 集合	一周中每个员工可以预订的小时数范围。 默认情况下，它们初始化为与业务的业务 Hours 属性相同。

关系

无

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "availabilityIsAffectedByPersonalCalendar": true,
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "role": {"@odata.type": "microsoft.graph.bookingStaffRole"},
  "useBusinessHours": true,
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}],
  "timeZone": "String"
}