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