Freigeben über


Wählen Sie eine API in Microsoft Graph aus, um Onlinebesprechungen zu erstellen und daran teilzunehmen.

Microsoft Graph bietet zwei API-Gruppen, die Onlinebesprechungen in Microsoft Teams oder Skype anordnen und die Teilnahme daran ermöglichen:

Die Wahl liegt zwischen:

  • Einer praktischen programmgesteuerten Methode zum Einrichten einer Onlinebesprechung im Outlook-Kalender, an der die Teilnehmer mit einem Klick teilnehmen können, ohne die Microsoft Teams- oder Skype-Umgebung zu verlassen.
  • Eine umfangreichere programmatische Integration von Teams- oder Skype-Features in einer App für eine individuellere Erfahrung.

Überlegungen bei der Auswahl einer API für Ihr Szenario

Wählen Sie die Kalender-API für eine optimierte, integrierte Integration in den Outlook-Kalender, die zu einer Online-Besprechung im Outlook-Kalender führt:

  • Unterstützung durch programmgesteuerte Funktionen:
    • Apps können direkt im Outlook-Kalender ein Ereignis als Onlinebesprechung erstellen oder aktualisieren, wobei ein Microsoft Teams-Besprechungs-Blob in das Outlook-Kalenderereignis eingefügt wird.
    • Apps erhalten Eigenschaften für die Teilnahme an Besprechungen über das Internet oder das Einwählen.
  • Die Benutzeroberflächenfunktion mit dem programmgesteuert erstellten Kalenderereignis ist gänzlich vergleichbar mit einem Ereignis, das über die Outlook-Benutzeroberfläche erstellt wurde:
    • Die Teilnehmer können sich online oder persönlich treffen.
    • Die Teilnehmer können auf den Blob zur Teilnahme an Microsoft Teams-Besprechung klicken, um über das Internet oder durch Einwählen an einer Besprechung teilzunehmen.
    • Falls entsprechend konfiguriert, können die Teilnehmer andere umfassende Features von Microsoft Teams verwenden, einschließlich Videokonferenzen und Wartebereich.

Hinweis

Die Integration mit dem Outlook-Kalender setzt voraus, dass ein Administrator Outlook für Online-Besprechungen eingerichtet hat. Überprüfen Sie vor der Verwendung der API den Support.

Wählen Sie die Cloud-Kommunications-API für mehr Flexibilität und umfassendere programmgesteuerte Möglichkeiten:

  • Apps bieten mehr Flexibilität für die weitere Integration der API-Ergebnisse in Branchenanwendungen und andere Apps. Die API ist nicht mit einem bestimmten Kalender gekoppelt und erstellt in keinem Kalender Ereignisse.
  • Apps können die folgenden Funktionen für Teilnehmer bereitstellen:
    • Länderspezifische Informationen für die Teilnahme
    • Teilnahme an einer Besprechung über das Internet oder über Einwählen
    • Video-Konferenzen
    • Zusätzliche Sicherheitsfeatures wie den Wartebereich und die Automatisierung des Teilnehmerzugangs (Vorschau)
    • Zuordnen einer Besprechung zu einem Microsoft Teams-Chat

Die APIs im Vergleich

In der folgenden Tabelle sind die Unterschiede auf API-Ebene im Detail aufgeführt.

Online-Besprechungsfeature Kalender-API (event-Ressource) Cloud-Kommunikations-API (onlineMeeting-Ressource)
API-Hauptmitglieder Ressource event:
- isOnlineMeeting-Eigenschaft
- onlineMeeting-Eigenschaft des onlineMeetingInfo-Typs
- onlineMeetingProvider-Eigenschaft
Ressource calendar:
- allowedOnlineMeetingProviders-Eigenschaft
- defaultOnlineMeetingProvider-Eigenschaft
Ressource onlineMeeting
Ressource audioConferencing
Integration in ein Kalenderelement
- Die Api zum Erstellen oder Aktualisieren von Ereignissen legt das resultierende Outlook-Kalenderereignis automatisch als Onlinebesprechung fest.
- Es werden die isOnlineMeeting-, onlineMeeting- und onlineMeetingProvider-Eigenschaften des zurückgegebenen Outlook-Kalenderereignisses verwendet.
- Die create-API gibt eine onlineMeeting-Ressource zurück, die von einem bestimmten Kalendertyp unabhängig ist.
- Erstellt oder aktualisiert keine Outlook-Ereignisse.
- Die zurückgegebenen onlineMeeting-Ressourceninformationen werden in eine für Ihr Szenario geeignete App-Umgebung integriert.
- createOrGet wird verwendet, um eine Onlinebesprechung zurückzugeben, die über einen angegebenen externalId-Wert verfügt, oder es wird eine erstellt, wenn noch keine vorhanden ist, um das Einbetten der resultierenden Besprechung in den Kalender eines Drittanbieters zu vereinfachen.
Wechseln zu Offline-Besprechung - Nein. Wenn Sie ein Ereignis für die Online-Teilnahme aktiviert haben, können Sie es nicht zu einer Offline-Besprechung ändern.
- Die onlineMeetingProvider-Eigenschaft kann nicht geändert und isOnlineMeeting kann nicht auf false festgelegt werden, um die Besprechung online zu deaktivieren.
Nein. Nachdem Sie eine onlineMeeting-Ressource erstellt haben, können Sie sie nur löschen, aber nicht in eine Offline-Besprechung umwandeln.
Gebietsschemabasierte Informationen für die Teilnahme Keine direkte API-Integration. - Verwenden Sie beim Erstellen einer Onlinebesprechung den Accept-Language-HTTP-Header.
- Siehe Beispiel.
Teilnahme über das Internet (VoIP) Über die Eigenschaft onlineMeeting erfolgt der Zugriff auf joinUrl. Es wird die joinWebUrl-Eigenschaft verwendet.
Beitreten durch Einwahl Über die onlineMeeting-Eigenschaft erfolgt der Zugriff auf:
- conferenceId, quickDial, phones, tollFreeNumbers, tollNumber.
Über die audioConferencing-Eigenschaft erfolgt der Zugriff auf:
- conferenceId, tollFreeNumber, tollNumber.
- dialinUrl-Eigenschaft für eine extern zugängliche Webseite, die Einwahlinformationen enthält, um die Integration in Apps von Drittanbietern zu vereinfachen.
Teilnahme über Videokonferenz (Audio und Video) Keine direkte API-Integration. Es wird die videoTeleconferenceId-Eigenschaft verwendet.
Wartebereich und Automatisierung des Teilnehmer-Zugangs zur Onlinebesprechung - Keine direkte API-Integration.
- Sofern vom Administrator aktiviert, können Teilnehmer in dem injizierten Ereignis-Blob zur Teilnahme an der Microsoft Teams-Besprechung auf einen Link zu Besprechungsoptionen klicken, um zum Warteraum zu gelangen.
- Die API unterscheidet zwischen Teilnehmern des Unternehmens des Veranstalters und jenen verbundener Unternehmen sowie anderen Teilnehmern, einschließlich anonymer Personen.
– Verwenden Sie die LobbyBypassSettings-Eigenschaft .
Im Zusammenhang mit einem Microsoft Teams-Chat Keine direkte API-Integration. Es wird die chatInfo-Eigenschaft verwendet.