bookingStaffMember リソースの種類

[アーティクル]
02/14/2024

名前空間: 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 人のスタッフメンバーをサポートしています。

メソッド

メソッド	戻り値の型	説明
スタッフメンバーを一覧表示する	bookingStaffMember コレクション	指定した bookingBusiness 内の bookingStaffMember オブジェクトの一覧を取得します。
BookingStaff を作成する	bookingStaffMember コレクション	指定した bookingBusiness に新しい bookingStaffMember を作成します。
BookingStaffMember を取得する	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)"
}