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

[アーティクル]
04/21/2024

名前空間: 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 オブジェクトのプロパティとリレーションシップを読み取ります。
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"
    }
}