bookingStaffMember リソースの種類

名前空間: microsoft.graph

bookingBusiness でサービスを提供するスタッフ メンバーを表します

スタッフ メンバーは、予約ビジネスが構成されているMicrosoft 365テナントの一部にしたり、他の電子メール プロバイダーからのメール サービスを使用したりできます。

予定を予約する場合、Bookings API は、スタッフ メンバーの空き時間を決定するために次の設定を考慮します。

  1. 既定では、ビジネスの稼働時間 (bookingBusinessエンティティの businessHours プロパティ) は、スタッフ メンバーの一般的な可用性を表します。
  2. useBusinessHours が false の場合、スタッフ メンバーの特定の勤務時間 (bookingStaffmember エンティティの workingHours プロパティ) は、そのメンバーの一般提供を表します。
  3. availabilityIsAffectedByPersonalCalendar が true の場合、Bookings API は最初にスタッフ メンバーの一般的に利用可能な時間 (#1 または #2 によって決まる) を確認し、予約を行う前に、スタッフ メンバーの個人カレンダーでそれらの時間の空き時間を確認します。

bookingStaffMemberBase から継承します

Microsoft Bookings では、予約カレンダーで最大 100 人のスタッフ メンバーがサポートされています。

メソッド

メソッド 戻り値の型 説明
スタッフ メンバーの一覧 bookingStaffMember コレクション 指定した bookingbusiness の bookingStaffMember オブジェクトの一覧 を取得します
BookingStaff の作成 bookingStaffMember コレクション 指定した bookingbusiness で 新しい bookingStaffMember を作成します
Get bookingStaffMember bookingStaffMember 指定した bookingbusiness で bookingStaffMember のプロパティとリレーションシップ を取得します
Update bookingStaffMember 指定した bookingbusiness で bookingStaffMemberプロパティを更新します
Delete なし 指定した bookingbusiness のスタッフ メンバーを削除します

プロパティ

プロパティ 種類 説明
availabilityIsAffectedByPersonalCalendar ブール型 True は、スタッフ メンバーが Microsoft 365 ユーザーの場合、予約を行う前に、Microsoft 365 の個人用予定表でスタッフ メンバーの空き時間を確認します。
displayName String 顧客に表示されるスタッフ メンバーの名前。 必須です。
emailAddress String スタッフ メンバーの電子メール アドレス。 これは、ビジネスと同じMicrosoft 365、または別の電子メール ドメインに含まれる場合があります。 この電子メール アドレスは、ビジネスのスケジュール ポリシーで sendConfirmationsToOwner プロパティが true に設定されている場合に使用できます。 必須。
id String GUID 形式のスタッフ メンバーの ID。 読み取り専用。
role bookingStaffRole ビジネスのスタッフ メンバーの役割。 使用できる値は guest administrator viewer 、、、、 externalGuest および unknownFutureValue です。 必須です。
timeZone String スタッフ メンバーのタイム ゾーン。 使用できる値の一覧については 、「dateTimeTimeZone」を参照してください
useBusinessHours ブール型 True は、スタッフ メンバーの可用性がビジネスの businessHours プロパティで指定された通りである場合を意味します。 False は、スタッフ メンバーの workingHours プロパティ設定によって可用性 が決定されます
workingHours bookingWorkHours コレクション スタッフメンバーが予約可能な週の各日の時間の範囲。 既定では、ビジネスの businessHours プロパティと同じに初期化されます。

リレーションシップ

なし

JSON 表記

リソースの JSON 表記を次に示します。

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