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:

• Kalender-API: Es wird die event-Ressource verwendet.
• Cloud-Kommunikations-API: Es wird die onlineMeeting-Ressource verwendet.

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.