virtualAppointment-Ressourcentyp (veraltet)

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Achtung

Die Virtuelle Terminressource und die unterstützenden Methoden sind veraltet und geben am 30. Juni 2023 keine Daten mehr zurück. Es wird empfohlen, vorhandene Apps, die diese API verwenden, auf die neue Funktion Get Virtual appointment join link (Virtuellen Terminbeitritt abrufen) zu aktualisieren.

Stellt Informationen zu einem virtuellen Termin dar, einschließlich der Clientbeitritts-URL, Einstellungen und Clientinformationen. Virtuelle Termine sind für Unternehmen konzipiert, um Onlineworkflows zu nutzen, und enthalten erweiterte Features wie den Mobilen Browserbeitritt und den Clientwarteraum.

Hinweis

Für den Vorschauzeitraum profitieren Kunden mit Zugriff auf virtuelle Termine mit ihren Microsoft 365-Lizenzen von unbegrenzten virtuellen Terminanrufen über die Microsoft Graph-API. Wir stellen zusätzliche Details zu den Lizenzierungsanforderungen bereit, bevor der Vorschauzeitraum endet.

Methoden

Methode	Rückgabetyp	Beschreibung
Erstellen von virtualAppointment	virtualAppointment	Erstellen Sie ein neues virtualAppointment-Objekt .
VirtualAppointment abrufen	virtualAppointment	Liest die Eigenschaften und Beziehungen eines virtualAppointment-Objekts .
VirtualAppointment aktualisieren	Keine	Aktualisieren sie die Eigenschaften eines virtualAppointment-Objekts .
VirtualAppointment löschen	Keine	Löschen sie ein virtualAppointment-Objekt .

Tipp

Wenn Sie zum ersten Mal eine virtuelle Terminressource in einem Mandanten erstellen, gibt die Anforderung einen 409 Conflict Antwortcode mit einem Wiederholungsheader zurück, der angibt, wie lange ein Aufrufer warten soll, bevor er die Anforderung erneut sendet. Die Dienstbereitstellung dauert weniger als fünf Minuten. Dieser Schritt ist nur einmal pro Kundenmandanten erforderlich.

Eigenschaften

Eigenschaft	Typ	Beschreibung
appointmentClients	virtualAppointmentUser-Sammlung	Die Clientinformationen für den virtuellen Termin, einschließlich Name, E-Mail und SMS-Telefonnummer. Optional.
appointmentClientJoinWebUrl	String	Die Web-URL des virtuellen Termins für Clients mit Warteraum und Browsereinbindung. Optional.
externalAppointmentId	String	Der Bezeichner des Termins aus dem Terminplanungssystem, der dem aktuellen virtuellen Termin zugeordnet ist. Optional.
externalAppointmentUrl	String	Die URL der Terminressource aus dem Terminplanungssystem, die dem aktuellen virtuellen Termin zugeordnet ist. Optional.
settings	virtualAppointmentSettings	Die Einstellungen, die der virtuellen Terminressource zugeordnet sind. Optional.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
    "@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"
    }
}