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エンティティのプロパティ) は、スタッフメンバーの一般利用可能性を表します。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 指定したbookingbusinessbookingStaffMemberオブジェクトのリストを取得します。Get a list of bookingStaffMember objects in the specified bookingbusiness.
BookingStaff を作成するCreate bookingStaff bookingStaffMemberコレクションbookingStaffMember collection 指定したbookingbusinessで新しいbookingStaffMemberを作成します。Create a new bookingStaffMember in the specified bookingbusiness.
BookingStaffMember を取得するGet bookingStaffMember bookingStaffMemberbookingStaffMember 指定したbookingbusinessbookingStaffMemberのプロパティとリレーションシップを取得します。Get the properties and relationships of a bookingStaffMember in the specified bookingbusiness.
UpdateUpdate bookingStaffMemberbookingStaffMember 指定したbookingbusinessbookingStaffMemberのプロパティを更新します。Update the properties of a bookingStaffMember in the specified bookingbusiness.
DeleteDelete NoneNone 指定した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 StringString スタッフメンバーの名前。顧客に表示されます。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. 使用可能な値は、guestadministratorviewerexternalGuest です。Possible values are: guest, administrator, viewer, externalGuest. 必須です。Required.
useBusinessHoursuseBusinessHours BooleanBoolean True は、スタッフメンバーの可用性が、ビジネスのプロパティで指定されていることを意味します。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 Bookingwork hoursコレクション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"}]