bookingStaffMember 资源类型bookingStaffMember resource type


Microsoft Graph 中/beta的版本下的 api 可能会发生更改。APIs under the /beta version in Microsoft Graph are subject to change. 不支持在生产应用程序中使用这些 API。Use of these APIs in production applications is not supported.

表示在bookingBusiness中提供服务的教职员工成员。Represents a staff member who provides services in a bookingBusiness.

教职员工成员可以是在其中配置预订业务的 Office 355 租户的一部分, 也可以使用来自其他电子邮件提供商的电子邮件服务。Staff members can be part of the Office 355 tenant where the booking business is configured, or they can use email services from other email providers.

预订约会时, 预订 API 会考虑以下设置以确定教职员工成员的可用性:When booking appointments, the Bookings API considers the following settings to determine a staff member's availability:

  1. 默认情况下, 业务的运营时间 ( bookingBusiness实体的businessHours属性) 表示教职员工成员的正式可用性。By default, the hours of operation of the business (the businessHours property of the bookingBusiness entity) represents the general availability of the staff member.
  2. 如果useBusinessHours为 false, 则教职员工成员的特定工作时间 ( BookingStaffmember实体的workingHours属性) 表示该成员的常规可用性。If useBusinessHours is false, then the staff member's specific work hours (workingHours property of the bookingStaffmember entity) represents that member's general availability.
  3. 如果availabilityIsAffectedByPersonalCalendar为 true, 则预订 API 将首先查看教职员工成员的可用小时数 (由 #1 或 #2 决定), 并在教职员工成员个人的这些时间内验证可用性。日历, 在进行预定前。If availabilityIsAffectedByPersonalCalendar is true, then the Bookings API would first look at the staff member's generally available hours (as determined by either #1 or #2), and verify availability during those hours in the staff member's personal calendar, before making a booking.


方法Method 返回类型Return Type 说明Description
列出教职员工成员List staff members bookingStaffMember集合bookingStaffMember collection 获取指定bookingbusiness中的bookingStaffMember对象的列表。Get a list of bookingStaffMember objects in the specified bookingbusiness.
创建 bookingStaffCreate bookingStaff bookingStaffMember集合bookingStaffMember collection 在指定的bookingbusiness中创建新的bookingStaffMemberCreate a new bookingStaffMember in the specified bookingbusiness.
获取 bookingStaffMemberGet bookingStaffMember bookingStaffMemberbookingStaffMember 获取指定bookingbusiness中的bookingStaffMember的属性和关系。Get the properties and relationships of a bookingStaffMember in the specified bookingbusiness.
更新Update bookingStaffMemberbookingStaffMember 更新指定bookingbusiness中的bookingStaffMember的属性。Update the properties of a bookingStaffMember in the specified bookingbusiness.
删除Delete None 删除指定bookingbusiness中的教职员工成员。Delete a staff member in the specified bookingbusiness.


属性Property 类型Type 说明Description
availabilityIsAffectedByPersonalCalendaravailabilityIsAffectedByPersonalCalendar BooleanBoolean 如果为 True, 则表示如果教职员工成员是 Office 365 用户, 则在预定前, 预订 API 将验证教职员工成员在 Office 365 的个人日历中的可用性。True means that if the staff member is an Office 365 user, the Bookings API would verify the staff member's availability in their personal calendar in Office 365, before making a booking.
colorIndexcolorIndex Int32Int32 标识代表教职员工成员的颜色。Identifies a color to represent the staff member. 该颜色对应于预订应用中的 "员工详细信息" 页上的调色板。The color corresponds to the color palette in the Staff details page in the Bookings app.
displayNamedisplayName 字符串String 向客户显示的教职员工成员的姓名。The name of the staff member, as displayed to customers. 必需。Required.
emailAddressemailAddress StringString 教职员工成员的电子邮件地址。The email address of the staff member. 这可以位于与企业相同的 Office 365 租户中, 也可以位于不同的电子邮件域中。This can be in the same Office 365 tenant as the business, or in a different email domain. 如果在企业的计划策略中将sendConfirmationsToOwner属性设置为 true, 则可以使用此电子邮件地址。This email address can be used if the sendConfirmationsToOwner property is set to true in the scheduling policy of the business. 必需。Required.
idid StringString 以 GUID 格式的教职员工成员的 ID。The ID of the staff member, in a GUID format. 只读。Read-only.
rolerole stringstring 企业中教职员工成员的角色。The role of the staff member in the business. 可取值为:guestadministratorviewerexternalGuestPossible values are: guest, administrator, viewer, externalGuest. 必需。Required.
useBusinessHoursuseBusinessHours BooleanBoolean 如果为 True, 则表示教职员工成员的可用性是在企业的businessHours属性中指定的。True means the staff member's availability is as specified in the businessHours property of the business. False 表示可用性由教职员工成员的workingHours属性设置决定。False means the availability is determined by the staff member's workingHours property setting.
workingHoursworkingHours bookingWorkHours集合bookingWorkHours collection 教职员工成员可用于预订的一周中每一天的小时数。The range of hours each day of the week that the staff member is available for booking. 默认情况下, 它们被初始化为与企业的businessHours属性相同。By default, they are initialized to be the same as the businessHours property of the business.



JSON 表示形式JSON representation

下面是资源的 JSON 表示形式。The following is a JSON representation of the resource.

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