bookingStaffMember リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
BookingBusiness でサービスを提供するスタッフ メンバーを表します。
スタッフ メンバーは、予約ビジネスが構成されている Microsoft 365 テナントの一部であるか、他のメール プロバイダーからのメール サービスを使用できます。
予定を予約する場合、Bookings API では、スタッフ メンバーの可用性を決定するために、次の設定が考慮されます。
- 既定では、ビジネスの営業時間 (BookingBusiness エンティティの businessHours プロパティ) は、スタッフ メンバーの一般提供を表します。
- useBusinessHours が false の場合、スタッフ メンバーの特定の勤務時間 (bookingStaffmember エンティティの workingHours プロパティ) はそのメンバーの一般提供を表します。
- availabilityIsAffectedByPersonalCalendar が true の場合、Bookings API は、最初にスタッフ メンバーの一般公開時間 (#1 または #2 によって決定) を確認し、予約を行う前に、スタッフ メンバーの個人用予定表でそれらの時間の可用性を確認します。
Microsoft Bookingsは、予約カレンダーで最大 100 人のスタッフメンバーをサポートしています。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | bookingStaffMember コレクション | 指定した bookingBusiness 内の bookingStaffMember オブジェクトの一覧を取得します。 |
| Create | bookingStaffMember コレクション | 指定した bookingBusiness に新しい bookingStaffMember をCreateします。 |
| Get | bookingStaffMember | 指定した bookingBusiness 内の bookingStaffMember のプロパティとリレーションシップを取得します。 |
| Update | なし | 指定した bookingBusiness 内の bookingStaffMember のプロパティを更新します。 |
| Delete | なし | 指定した bookingBusiness 内のスタッフ メンバーを削除します。 |
プロパティ
| プロパティ | 種類 | 説明 |
|---|---|---|
| availabilityIsAffectedByPersonalCalendar | ブール型 | True は、スタッフ メンバーが Microsoft 365 ユーザーの場合、Bookings API は、予約を行う前に、Microsoft 365 の個人用予定表でスタッフ メンバーの可用性を確認することを意味します。 |
| colorIndex | Int32 | スタッフ メンバーを表す色を識別します。 色は、Bookings アプリの [スタッフの詳細] ページのカラー パレットに対応します。 |
| createdDateTime | DateTimeOffset | スタッフ メンバーが作成された日付、時刻、タイム ゾーン。 |
| displayName | String | 顧客に表示されるスタッフ メンバーの名前。 必須です。 |
| emailAddress | String | スタッフ メンバーのメール アドレス。 このメール アドレスは、ビジネスと同じ Microsoft 365 テナント内、または別のメール ドメイン内に存在できます。 このメール アドレスは、ビジネスのスケジューリング ポリシーで sendConfirmationsToOwner プロパティが true に設定されている場合に使用できます。 必須。 |
| id | String | GUID 形式のスタッフ メンバーの ID。 読み取り専用。 |
| isEmailNotificationEnabled | ブール型 | スタッフメンバーに割り当てられた予約が作成または変更されたときに、スタッフメンバーに電子メールで通知されることを示します。 既定値は true |
| lastUpdatedDateTime | DateTimeOffset | スタッフ メンバーが最後に更新された日付、時刻、タイム ゾーン。 |
| role | bookingStaffRole | ビジネスにおけるスタッフ メンバーの役割。 可能な値は、guest、administrator、viewer、externalGuest、unknownFutureValue、scheduler、teamMember です。 要求ヘッダーを使用して、Prefer: include-unknown-enum-membersこの進化可能な列挙型から次の値を取得する必要があります。 schedulerteamMember 必須。 |
| timeZone | String | スタッフ メンバーのタイム ゾーン。 使用可能な値の一覧については、「 dateTimeTimeZone」を参照してください。 |
| useBusinessHours | ブール型 | True は、スタッフ メンバーの可用性が ビジネスの businessHours プロパティで指定されていることを意味します。 False は、スタッフ メンバーの workingHours プロパティ設定によって可用性が決定されていることを意味します。 |
| workingHours | bookingWorkHours コレクション | スタッフメンバーが予約可能な曜日の時間の範囲。 既定では、これらはビジネスの businessHours プロパティと同じに初期化されます。 |
リレーションシップ
なし
JSON 表記
次の JSON は、リソースの表現です。
{
"@odata.type": "#microsoft.graph.bookingStaffMember",
"id": "String (identifier)",
"displayName": "String",
"emailAddress": "String",
"availabilityIsAffectedByPersonalCalendar": "Boolean",
"colorIndex": "Integer",
"role": "String",
"useBusinessHours": "Boolean",
"workingHours": [
{
"@odata.type": "microsoft.graph.bookingWorkHours"
}
],
"timeZone": "String",
"isEmailNotificationEnabled": "Boolean",
"createdDateTime": "String (timestamp)",
"lastUpdatedDateTime": "String (timestamp)"
}