bookingStaffMember リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

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

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

予定を予約する場合、Bookings API は次の設定を考慮してスタッフ メンバーの空き状況を判断します。

1. 既定では、ビジネスの営業時間 (bookingBusiness エンティティの businessHours プロパティ) は、スタッフ メンバーの一般提供時間を表します。
2. useBusinessHours が false の場合、スタッフ メンバーの特定の作業時間 (bookingStaffmember エンティティの workingHours プロパティ) は、そのメンバーの一般提供を表します。
3. availabilityIsAffectedByPersonalCalendar が true の場合、Bookings API はまずスタッフ メンバーの一般提供時間 (#1 または #2 によって決定) を確認し、予約を行う前にスタッフ メンバーの個人用カレンダーでその時間帯の可用性を確認します。

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

メソッド

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

プロパティ

プロパティ	種類	説明
availabilityIsAffectedByPersonalCalendar	ブール型	True は、スタッフ メンバーがMicrosoft 365 ユーザーである場合、Bookings API は、予約を行う前に、Microsoft 365の個人用カレンダーでスタッフ メンバーの可用性を確認することを意味します。
colorIndex	Int32	スタッフ メンバーを表す色を識別します。 色は、Bookings アプリの [スタッフの詳細 ] ページのカラー パレットに対応します。
displayName	String	顧客に表示されるスタッフ メンバーの名前。 必須です。
emailAddress	String	スタッフメンバーのメール アドレス。 これは、ビジネスと同じMicrosoft 365テナント内でも、別の電子メール ドメイン内でもかまいません。 この電子メール アドレスは、ビジネスのスケジュール ポリシーで sendConfirmationsToOwner プロパティが true に設定されている場合に使用できます。 必須。
id	String	スタッフ メンバーの ID (GUID 形式)。 読み取り専用。
IsEmailNotificationEnabled	ブール型	True つまり、割り当てられた予約が作成または変更されると、スタッフ メンバーに電子メールで通知されます。
role	bookingStaffRole	ビジネスにおけるスタッフ メンバーの役割。 指定できる値は、次 viewer``scheduler member``administrator``unknownFutureValue``externalGuestのとおりです。 guest 次の値[evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations)をPrefer: include-unknown-enum-members取得するには、要求ヘッダーを使用する必要があることに注意してください。 scheduler``member 必須です。
timeZone	String	スタッフ メンバーのタイム ゾーン。 使用可能な値の一覧については、「 dateTimeTimeZone」を参照してください。
useBusinessHours	ブール型	True は、スタッフ メンバーの可用性が、ビジネスの businessHours プロパティで指定されたとおりであることを意味します。 False は、スタッフ メンバーの workingHours プロパティ設定によって可用性が決定されていることを意味します。
workingHours	bookingWorkHours コレクション	スタッフメンバーが予約できる曜日ごとの時間の範囲。 既定では、ビジネスの businessHours プロパティと同じに初期化されます。

リレーションシップ

なし

JSON 表記

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

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