bookingStaffMember 资源类型
命名空间：microsoft.graph
代表在 bookingBusiness 中提供服务的员工。
员工成员可以是配置 预订业务的 Microsoft 365 租户的一部分，也可以使用来自其他电子邮件提供商的电子邮件服务。
预订约会时，Bookings API 会考虑以下设置来确定员工的可用性：
- 默认情况下，业务运营时间 (bookingBusiness 实体的 businessHours 属性) 表示员工正式发布。
- 如果 useBusinessHours 为 false，则员工成员的特定工作时间 (bookingStaffmember 实体的 workingHours 属性) 表示该成员的正式发布。
- 如果 availabilityIsAffectedByPersonalCalendar 为 true，则 Bookings API 将首先查看 (由 #1 或 #2) 确定的员工成员的正式可用时段，并在员工的个人日历中验证这些时段内的可用性，然后再进行预订。
Microsoft Bookings 在一个预订日历中最多支持 100 名员工。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | bookingStaffMember 集合 | 获取指定 bookingBusiness 中的 bookingStaffMember 对象列表。 |
| 创建 | bookingStaffMember 集合 | 在指定的 bookingBusiness 中创建新的 bookingStaffMember。 |
| Get | bookingStaffMember | 获取指定 bookingBusiness 中 bookingStaffMember 的属性和关系。 |
| 更新 | 无 | 更新指定 bookingBusiness 中 bookingStaffMember 的属性。 |
| 删除 | None | 删除指定 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"}]
}