virtualAppointment リソースの種類 (非推奨)

名前空間: microsoft.graph

重要

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

注意

仮想予定リソースとサポート メソッドは非推奨となり、2023 年 6 月 30 日にデータの返しを停止します。 この API を使用する既存のアプリを、新しい [仮想予定の取得] 参加リンク 関数に更新することをお勧めします。

クライアント参加 URL、設定、クライアント情報など、仮想予定に関する情報を表します。 仮想予定は、オンライン ワークフローを使用するようにビジネス向けに設計されており、モバイル ブラウザー参加やクライアント待合室などの強化された機能が含まれています。

注:

プレビュー期間中、Microsoft 365 ライセンスを使用して仮想予定にアクセスできるお客様は、Microsoft Graph API を介した無制限の仮想予定呼び出しの恩恵を受けることができます。 プレビュー期間が終了する前に、ライセンス要件の詳細を提供します。

メソッド

メソッド	戻り値の種類	説明
仮想予定の作成 (非推奨)	virtualAppointment	新しい virtualAppointment オブジェクトを 作成します。
仮想予定を取得する (非推奨)	virtualAppointment	virtualAppointment オブジェクトのプロパティとリレーションシップを読み取ります。
仮想予定を更新する (非推奨)	なし	virtualAppointment オブジェクトのプロパティを更新します。
仮想予定を削除する (非推奨)	なし	virtualAppointment オブジェクトを削除します。

ヒント

テナントで初めて仮想予定リソースを作成すると、要求は再試行ヘッダーを含む 409 Conflict 応答コードを返します。このコードは、呼び出し元が要求を再度行う前に待機する時間を示します。 サービス のプロビジョニングにかかる時間は 5 分未満です。 この手順は、顧客テナントごとに 1 回だけ必要です。

プロパティ

プロパティ	型	説明
appointmentClients	virtualAppointmentUser コレクション	名前、電子メール、SMS 電話番号など、仮想予定のクライアント情報。 省略可能。
appointmentClientJoinWebUrl	String	待機室とブラウザー参加を持つクライアントの仮想予定の結合 Web URL。 省略可能。
externalAppointmentId	String	現在の仮想予定に関連付けられているスケジューリング システムからの予定の識別子。 省略可能。
externalAppointmentUrl	String	現在の仮想予定に関連付けられているスケジューリング システムからの予定リソースの URL。 省略可能。
settings	virtualAppointmentSettings	仮想予定リソースに関連付けられている設定。 省略可能。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
    "@odata.type": "#microsoft.graph.virtualAppointment",
    "appointmentClients": [
        {
            "@odata.type": "microsoft.graph.virtualAppointmentUser"
        }
    ],
    "appointmentClientJoinWebUrl": "String",
    "externalAppointmentId": "String",
    "externalAppointmentUrl": "String",
    "id": "String (identifier)",
    "settings": {
        "@odata.type": "microsoft.graph.virtualAppointmentSettings"
    }
}