bookingAppointment リソースの種類

名前空間: microsoft.graph

Microsoft Bookingsビジネスによって提供される一連のスタッフ メンバーによって実行される bookingService の顧客の予定を表します。

注意

アプリケーションのアクセス許可を使用してカスタム アプリを作成する場合は、 ビジネス ルールの検証に従う必要があります。

メソッド

メソッド	戻り値の型	説明
予定を一覧表示する	bookingAppointment コレクション	指定した Bookingbusiness 内の bookingAppointment オブジェクトの一覧を取得します。
bookingAppointment を作成する	bookingAppointment	指定した bookingbusiness の新しい bookingAppointment を作成します。
BookingAppointment を取得する	bookingAppointment	bookingAppointment オブジェクトのプロパティとリレーションシップを読み取ります。
Update	bookingAppointment	bookingAppointment オブジェクトを更新します。
Delete	なし	bookingAppointment オブジェクトを削除します。
Cancel	なし	bookingAppointment オブジェクトをキャンセルします。

プロパティ

プロパティ	型	説明
additionalInformation	String	予定が確認されたときに顧客に送信される追加情報。
顧客	bookingCustomerInformation コレクション	予定の顧客プロパティが一覧表示されます。 予定には顧客情報の一覧が含まれており、各ユニットはその予定の一部である顧客のプロパティを示します。 省略可能。
customerTimeZone	String	顧客のタイム ゾーン。 使用可能な値の一覧については、「 dateTimeTimeZone」を参照してください。
duration	期間	ISO8601 形式で示される予定の長さ。
endDateTime	dateTimeTimeZone	予定が終了する日付、時刻、タイム ゾーン。
filledAttendeesCount	Int32	予定の現在の顧客数
id	String	bookingAppointment の ID。 読み取り専用です。
isLocationOnline	Boolean	場合 trueは、予定がオンラインで保持されることを示します。 既定値は、false です。
joinWebUrl	String	予定のオンライン会議の URL。
maximumAttendeesCount	Int32	予定で許可される顧客の最大数。 サービスの maximumAttendeesCount が 1 より大きい場合は、予定の作成または更新中に有効な顧客 ID を渡します。 顧客を作成するには、 BookingCustomer の作成操作を 使用します。
optOutOfCustomerEmail	Boolean	この予定の bookingCustomer が、この予定の確認を受け取りたくないことを示す場合true。
postBuffer	期間	例として、予定が終了した後に予約する時間 (クリーンアップ用) を指定します。 値は ISO8601 形式で表されます。
preBuffer	期間	準備のために、予定が開始される前に予約する時間を例に示します。 値は ISO8601 形式で表されます。
価格	倍精度浮動小数点数	指定した bookingService の予定の通常価格。
priceType	bookingPriceType	サービスの価格構造に柔軟性を提供する設定。 可能な値は、undefined、fixedPrice、startingAt、hourly、free、priceVaries、callUs、notSet、unknownFutureValue です。
アラーム	bookingReminder コレクション	この予定に対して送信された顧客のリマインダーのコレクション。 このプロパティの値は、ID でこの bookingAppointment を 読み取る場合にのみ使用できます。
selfServiceAppointmentId	String	顧客の代わりにスタッフが行うのではなく、スケジュール 設定ページで顧客によって直接予定が作成された場合、予定の追加の追跡 ID。 maxAttendeeCount が 1 の場合にのみ、予定に対してサポートされます。
serviceId	String	この予定に関連付けられている bookingService の ID。
serviceLocation	location	サービスが配信される場所。
serviceName	String	この予定に関連付けられている bookingService の名前。 このプロパティは、新しい予定を作成するときに省略可能です。 指定しない場合は、予定に関連付けられているサービスから serviceId プロパティによって計算されます。
serviceNotes	String	bookingStaffMember からのメモ。 このプロパティの値は、ID でこの bookingAppointment を 読み取る場合にのみ使用できます。
smsNotificationsEnabled	Boolean	場合 trueは、予定の顧客に SMS 通知が送信されることを示します。 既定値は、false です。
staffMemberIds	String collection	この予定でスケジュールされている各 bookingStaffMember の ID。
startDateTime	dateTimeTimeZone	予定が開始される日付、時刻、タイム ゾーン。

リレーションシップ

なし。

JSON 表記

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

{
  "customers": [
    {
      "@odata.type": "microsoft.graph.bookingCustomerInformation"
    }
  ],
  "duration": "String (timestamp)",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "id": "String (identifier)",
  "isLocationOnline": "Boolean",
  "joinWebUrl": "String",
  "optOutOfCustomerEmail": "Boolean",
  "postBuffer": "String (timestamp)",
  "preBuffer": "String (timestamp)",
  "price": "Integer",
  "priceType": {"@odata.type": "microsoft.graph.bookingPriceType"},
  "reminders": [{"@odata.type": "microsoft.graph.bookingReminder"}],
  "selfServiceAppointmentId": "String",
  "serviceId": "String",
  "serviceLocation": {"@odata.type": "microsoft.graph.location"},
  "serviceName": "String",
  "serviceNotes": "String",
  "smsNotificationsEnabled": "Boolean",
  "staffMemberIds": ["String"],
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "maximumAttendeesCount": "Integer",
  "filledAttendeesCount": "Integer"
}