bookingStaffMember 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
代表在 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 的个人日历中的可用性。 |
| colorIndex | Int32 | 标识表示教职员工的颜色。 该颜色对应于Bookings应用中“员工详细信息”页中的调色板。 |
| createdDateTime | DateTimeOffset | 创建员工成员的日期、时间和时区。 |
| displayName | String | 员工成员的姓名，如显示给客户。 必填。 |
| emailAddress | String | 工作人员的电子邮件地址。 此电子邮件地址可以位于与业务相同的 Microsoft 365 租户中，也可以位于其他电子邮件域中。 如果在业务的计划策略中 将 sendConfirmationsToOwner 属性设置为 true，则可以使用此电子邮件地址。 必需。 |
| id | String | 采用 GUID 格式的员工 ID。 只读。 |
| isEmailNotificationEnabled | 布尔值 | 指示在创建或更改分配给他们的预订时通过电子邮件通知员工。 默认值为 true |
| lastUpdatedDateTime | DateTimeOffset | 上次更新工作人员的日期、时间和时区。 |
| 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",
"id": "String (identifier)",
"displayName": "String",
"emailAddress": "String",
"availabilityIsAffectedByPersonalCalendar": "Boolean",
"colorIndex": "Integer",
"role": "String",
"useBusinessHours": "Boolean",
"workingHours": [
{
"@odata.type": "microsoft.graph.bookingWorkHours"
}
],
"timeZone": "String",
"isEmailNotificationEnabled": "Boolean",
"createdDateTime": "String (timestamp)",
"lastUpdatedDateTime": "String (timestamp)"
}