Freigeben über

Anwendungsfälle für webinar-API für virtuelle Ereignisse

Mit den Webinar-APIs für virtuelle Microsoft Graph-Ereignisse können Sie Teams-Webinardaten abrufen und programmgesteuert ein Teams-Webinar erstellen, aktualisieren und abbrechen.

Damit Sie die Webinar-APIs für virtuelle Graph-Ereignisse optimal nutzen können, ist es hilfreich, die Personas für die Benutzer zu verstehen, die auf das Microsoft Teams-Webinar zugreifen:

  • Organisatoren sind Mitarbeiter (in Ihrem organization), die das Webinar verwalten. Sie sind die Autorität nach Zeitplan und Teilnehmer. Sie konfigurieren Webinarattribute wie Titel, Design, Teilnehmererfahrung und E-Mail-Regeln.  
  • Referenten sind Mitarbeiter (in Ihrem organization) oder Gäste, die das Webinar leiten.  
  • Registranten sind Benutzer (in oder außerhalb Ihrer organization), die sich für ein Webinar registriert haben. Sie können registriert, in die Warteliste aufgenommen oder abgelehnt werden. Sie können ihre Webinar-Registrierung abbrechen.  
  • Teilnehmer sind Registranten, die an dem Webinar teilgenommen haben. Sie müssen sich über ein Portal registrieren und Registrierungsfragen beantworten.
  • Der Teams-Mandantenadministrator muss benutzerdefinierte Anwendungen mit den entsprechenden Berechtigungen autorisieren.

Sie können die folgenden Ressourcentypen verwenden, um Ihre Webinarlösung zu erstellen:

  • virtualEventWebinar : Dient zum Erstellen, Abrufen, Aktualisieren, Veröffentlichen, Abbrechen und Auflisten von Teams-Webinaren.
  • virtualEventRegistration : Dient zum Erstellen, Abrufen, Abbrechen und Auflisten von Registrierungsdatensätzen von Registranten eines Webinars. Stellt die eindeutige Teams-Webinarbeitritts-URL für den registrierten Registranten bereit.
  • virtualEventRegistrationQuestion : Dient zum Erstellen, Auflisten und Löschen von benutzerdefinierten Registrierungsfragen oder vordefinierten Registrierungsfragen, die Registranten beantworten können, wenn sie sich für ein Webinar registrieren.
  • virtualEventRegistrationConfiguration : Enthält Informationen zu einer Webinarregistrierungskonfiguration, in der die URL des Registrierungsportals des Webinars gespeichert wird.
  • virtualEventPresenter : Dient zum Erstellen, Abrufen, Auflisten, Aktualisieren und Löschen eines Referenten für ein Teams-Webinar.
  • virtualEventSession : Ein webinar, das über Microsoft Graph-APIs erstellt wurde, verfügt nur über eine Sitzung, die die Eigenschaften von Onlinebesprechungen erbt.
  • meetingAttendanceReport : Jedes Mal, wenn ein Webinar endet, wird ein Anwesenheitsbericht für die Sitzung generiert, der jedoch keine Teilnehmerdaten enthält.
  • attendanceRecord : Stellt Webinarteilnehmerdaten im Anwesenheitsbericht bereit.
  • Webhooks für virtuelle Ereignisse : Können Benachrichtigungen über Änderungen an einem Webinar, einer Webinarregistrierung, einer Sitzung, einem Anwesenheitsbericht usw. erhalten.

Lösungen, die Sie erstellen können

In der folgenden Tabelle sind einige Lösungen aufgeführt, die Sie mithilfe des Teams-Clients und der Microsoft Graph-Webinar-APIs und -Webhooks erstellen können.

Lösungen Beschreibung
Erstellen/Aktualisieren/Abbrechen Programmgesteuertes Erstellen, Aktualisieren und Abbrechen von Teams-Webinaren.
Datensynchronisierung Pullen von Teams-Webinardaten in einer benutzerdefinierten Anwendung (z. B. Teilnehmer, Registrierungsfragen, Anwesenheitsbericht usw.).
Registrierung Hosten Sie Ihr eigenes Registrierungsportal für ein Teams-Webinar, und synchronisieren Sie die Registrierungsdaten mit dem Teams-Client.
Email Kommunikation Verwenden Sie Ihre eigene E-Mail-Infrastruktur, um Webinar-bezogene Benachrichtigungs-E-Mails zu senden.

Hinweis

Zum Erstellen von Microsoft Graph-Lösungen müssen Sie sich registrieren und Ihrer Anwendung die richtigen Berechtigungen erteilen. Weitere Informationen finden Sie unter Grundlagen zu Authentifizierung und Autorisierung.

Mit der ressourcenspezifischen Zustimmung (Resource Specific Consent, RSC) können Apps Berechtigungen anfordern, die für ein bestimmtes Webinar oder ein bestimmtes Rathaus gelten, anstatt globale Administratorrechte zu erfordern. Die RSC-Berechtigungen verbessern die Sicherheit, vereinfachen Zustimmungsflüsse und ermöglichen Es Entwicklern, Integrationen zu erstellen, die Organisationsgrenzen berücksichtigen.

Aktivierte APIs für virtuelle Microsoft Graph-Ereignisse und RSC-Berechtigungen

RSC-Berechtigung APIs Beschreibung
VirtualEvent.Read.Chat Webinar und Rathaus Lesen Sie Informationen zu diesem Webinar oder rathaus, einschließlich Zeitplänen, Referenten, Veranstaltungseinstellungen und Webinarregistrierungen.
OnlineMeetingArtifact.Read.Chat Anwesenheitsbericht und Anwesenheitsaufzeichnung Lesen Sie Anwesenheitsberichte und Anwesenheitsaufzeichnungen für dieses Webinar oder dieses Rathaus.
VirtualEventRegistration-Anon.ReadWrite.Chat Registrierungen virtueller Ereignisse Teilnehmer registrieren und Registrierungen für dieses Webinar stornieren.

Herkömmlicher Authentifizierungsablauf

Wenn RSC nicht erforderlich oder durchführbar ist, können Sie die folgenden herkömmlichen OAuth-Flows verwenden:

  • Nur-App-Tokenflow: Verwenden Sie ihn für Back-End-Dienste oder Automatisierungsszenarien, in denen die App ohne Benutzerkontext agiert.
  • Delegierter Tokenfluss (Benutzer): Wird verwendet, wenn Aktionen Benutzerkontext und Zustimmung erfordern.

Wann sollte RSC im Vergleich zum herkömmlichen Tokenfluss verwendet werden?

Szenario Empfohlener Ansatz
Die App benötigt nur Zugriff auf ein bestimmtes Webinar oder ein Bestimmtes Rathaus. RSC
App erfordert mandantenweiten Zugriff auf mehrere Ereignisse Nur-App-Tokenflow
Benutzergesteuerte Aktionen wie die Organisatorverwaltung von Ereignissen Delegierter Tokenfluss
Compliance- oder Sicherheitsmandate erfordern die geringsten Rechte RSC

Erste Schritte mit RSC-Berechtigungen

In den folgenden Schritten wird beschrieben, wie Sie mit dem Einrichten Ihrer App und der Verwendung von RSC-Berechtigungen beginnen:

  1. Registrieren Sie Ihre App, und definieren Sie RSC-Berechtigungen im App-Manifest.
  2. Veröffentlichen Sie Ihre App über das Teams-Entwicklerportal oder Partner Center.
  3. Admin gewährt RSC im Teams Admin Center.
  4. Verwenden Sie die Microsoft Graph-APIs für Webinare und Rathäuser mit bereichsbezogenen Berechtigungen.

Erstellen/Aktualisieren/Abbrechen

  • Verwenden Sie die Api zum Erstellen eines Webinars , um einen Entwurf des Ereignisses zu erstellen, gefolgt von der Api zum Veröffentlichen von Webinaren , um die Erstellung abzuschließen und für die Zielgruppe sichtbar zu machen.
    • Das über Microsoft Graph-APIs erstellte Webinar ist ein Teams-Webinar, das im Teams-Client sichtbar und bearbeitet werden kann.
    • Genau wie in Teams kann nur der Organisator Webinarereignisse erstellen, veröffentlichen und abbrechen. Die API zum Erstellen eines Webinars unterstützt nur delegierte Berechtigungen im Namen des Organisators.
  • Wie in Teams können Mitorganisierer Webinare aktualisieren. Verwenden Sie zum Aktualisieren von Webinaren die Update-Webinar-API mit delegierten Berechtigungen im Namen des Coorganisierers.
  • Abonnieren Sie Änderungsbenachrichtigungen , um Updates zu änderungen zu erhalten, die am Webinar vorgenommen wurden. 

Datensynchronisierung

Registrierung

  • Verwenden Sie Registrierung erstellen , um Benutzer programmgesteuert für Ihr Webinar zu registrieren. Organisatoren, Mitorganisierer und Referenten müssen sich nicht registrieren. Ob Registranten über Microsoft Entra Konten verfügen oder nicht, wirkt sich auf die Berechtigungen aus, die Sie zum Aufrufen der API benötigen.
  • CREATE-Registrierungsfragen (vordefinierte oder benutzerdefinierte) Teilnehmer müssen während der Registrierung erforderliche Fragen beantworten.
  • Nachdem sich der Registrant für das Webinar registriert hat, verwenden Sie Listensitzungen , um die eindeutige joinWebURL für das Webinar zu erhalten.

Email Kommunikation

  • Sie können die E-Mail-Kommunikation an Teilnehmer deaktivieren, wenn Sie das Webinar erstellen. Legen Sie in der Einstellungseigenschaft auf fest isAttendeeEmailNotificationEnabledfalse. E-Mails werden weiterhin an Organisatoren, Co-Organisatoren und Referenten (intern und extern) gesendet.
  • Sie können Änderungsbenachrichtigungen abonnieren, um Ihr eigenes angepasstes E-Mail-Kommunikationssystem zu erstellen.
  • Last updated on