次の方法で共有


bookingStaffMember リソースの種類

名前空間: microsoft.graph

重要

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

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

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

予定を予約する場合、Bookings API では、スタッフ メンバーの可用性を決定するために、次の設定が考慮されます。

  1. 既定では、ビジネスの営業時間 (BookingBusiness エンティティの businessHours プロパティ) は、スタッフ メンバーの一般提供を表します。
  2. useBusinessHours が false の場合、スタッフ メンバーの特定の勤務時間 (bookingStaffmember エンティティの workingHours プロパティ) はそのメンバーの一般提供を表します。
  3. 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 ビジネスにおけるスタッフ メンバーの役割。 可能な値は、guestadministratorviewerexternalGuestunknownFutureValueschedulerteamMember です。 要求ヘッダーを使用して、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)"
}