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 名员工。

方法

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

属性

属性 类型 说明
availabilityIsAffectedByPersonalCalendar 布尔值 True 表示如果员工成员是 Microsoft 365 用户,则 Bookings API 将在进行预订前验证员工在 Microsoft 365 个人日历中的空位情况。
createdDateTime DateTimeOffset 创建员工成员的日期、时间和时区。 时间戳类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 格式。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
displayName String 员工成员的姓名,如显示给客户。 必填。
emailAddress String 工作人员的电子邮件地址。 此电子邮件地址可以位于与业务相同的 Microsoft 365 租户中,也可以位于其他电子邮件域中。 如果在业务的计划策略中 将 sendConfirmationsToOwner 属性设置为 true,则可以使用此电子邮件地址。 必需。
id String 采用 GUID 格式的员工 ID。 只读。
isEmailNotificationEnabled 布尔值 指示在创建或更改分配给他们的预订时通过电子邮件通知员工。 默认值为 true。
membershipStatus bookingStaffMembershipStatus 业务中员工的成员身份。 可能的值包括 active、pendingAcceptance、rejectedByStaff、unknownFutureValue。
lastUpdatedDateTime DateTimeOffset 上次更新工作人员的日期、时间和时区。 时间戳类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 格式。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
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 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.bookingStaffMember",
  "availabilityIsAffectedByPersonalCalendar": "Boolean",
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "isEmailNotificationEnabled": "Boolean",
  "lastUpdatedDateTime": "String (timestamp)",
  "role": "String",
  "timeZone": "String",
  "useBusinessHours": "Boolean",
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}]
}