bookingStaffMember 资源类型bookingStaffMember resource type

重要说明: Microsoft Graph 中 /beta 版本下的 API 是预览版,可能会发生变化。Important: APIs under the /beta version in Microsoft Graph are in preview and 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实体的工作时间属性) 的营业时间表示员工成员的常规可用性。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 字符串String 员工成员,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. 默认情况下,它们都初始化为业务的工作时间属性相同。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"}]