Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mit den Rathaus-APIs für virtuelle Microsoft Graph-Ereignisse können Sie Teams-Rathausdaten abrufen und programmgesteuert ein Teams-Rathaus erstellen, aktualisieren und abbrechen.
Damit Sie die Rathaus-APIs für virtuelle Microsoft Graph-Ereignisse optimal nutzen können, ist es hilfreich, die Personas für die Benutzer zu verstehen, die auf die Umgebung des Teams-Rathauses zugreifen:
- Organisatoren sind Mitarbeiter (in Ihrem organization), die das Rathaus verwalten. Sie sind die Autorität darüber, wann Rathäuser stattfinden und wer daran teilnimmt. Sie konfigurieren Rathausdetails wie Titel, Design, Teilnehmererfahrung und E-Mail-Regeln.
- Referenten sind Mitarbeiter (in Ihrem organization) oder Gäste, die das Rathaus leiten.
- Teilnehmer sind entweder Mitarbeiter (in Ihrem organization) oder Gäste, die dem Rathaus beitreten und entweder per E-Mail eingeladen werden oder der Link zum Rathausereignis mit ihnen geteilt wird.
- Der Teams-Mandantenadministrator muss benutzerdefinierte Anwendungen mit den entsprechenden Berechtigungen autorisieren.
Sie können die folgenden Ressourcentypen verwenden, um Ihre Rathauslösung zu erstellen:
- virtualEventTownhall : Wird zum Erstellen, Abrufen, Aktualisieren, Veröffentlichen und Abbrechen eines Teams-Rathauses verwendet.
- virtualEventPresenter : Dient zum Erstellen, Abrufen, Auflisten, Aktualisieren und Löschen eines Referenten für ein Teams-Rathaus.
- virtualEventSession : Ein über Microsoft Graph-APIs erstelltes Rathaus verfügt über eine Sitzung, die die Eigenschaften von Onlinebesprechungen erbt.
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-Rathaus-APIs und -Webhooks erstellen können.
| Lösungen | Beschreibung |
|---|---|
| Erstellen/Aktualisieren/Abbrechen | Programmgesteuertes Erstellen, Aktualisieren und Abbrechen des Teams-Rathauses. |
| Datensynchronisierung | Pullen Sie Teams-Rathausdaten in einer benutzerdefinierten Anwendung. |
| Email Kommunikation | Verwenden Sie Ihre eigene E-Mail-Infrastruktur, um Benachrichtigungs-E-Mails im Zusammenhang mit dem Rathaus 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.
Ressourcenspezifische Zustimmung (RSC) für virtuelle Ereignisse
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:
- Registrieren Sie Ihre App, und definieren Sie RSC-Berechtigungen im App-Manifest.
- Veröffentlichen Sie Ihre App über das Teams-Entwicklerportal oder Partner Center.
- Admin gewährt RSC im Teams Admin Center.
- Verwenden Sie die Microsoft Graph-APIs für Webinare und Rathäuser mit bereichsbezogenen Berechtigungen.
Erstellen/Aktualisieren/Abbrechen
- Verwenden Sie die API "Townhall erstellen" , um einen Entwurf des Ereignisses zu erstellen, gefolgt von der Api zum Veröffentlichen von Rathaus , um die Erstellung abzuschließen und für die Zielgruppe sichtbar zu machen.
- Das über Microsoft Graph-APIs erstellte Rathaus ist ein Teams-Rathausereignis, das im Teams-Client sichtbar und bearbeitet werden kann.
- Genau wie in Teams kann nur der Organisator Rathäuser erstellen, veröffentlichen und abbrechen. Die API zum Erstellen eines Rathauses unterstützt nur delegierte Berechtigungen im Namen des Organisators.
- Wie in Teams können Mitorganisierer Rathäuser aktualisieren. Um ein Rathaus zu aktualisieren, verwenden Sie die Api zum Aktualisieren des Rathauses mit delegierten Berechtigungen im Namen des Mitorganisierers.
Datensynchronisierung
- Verwenden Sie die GET TOWNHALL-API , um Daten zu einem bestimmten Rathaus abzurufen, z. B. wer eingeladen wird, wer das Rathaus erstellt hat und wer die Mitorganisierer sind.
- Listet alle Rathäuser in einem Mandanten auf, einschließlich der Rathäuser, deren Organisator oder Mitorganisierer der Benutzer ist. Dieses Szenario wird für delegierte Berechtigungen und Anwendungsberechtigungen unterstützt. Diese APIs sind derzeit nur im Betaendpunkt verfügbar.
Email Kommunikation
Sie können die E-Mail-Kommunikation an Teilnehmer deaktivieren, wenn Sie das Rathaus erstellen. Legen Sie in der Einstellungseigenschaft auf fest isAttendeeEmailNotificationEnabledfalse. E-Mails werden weiterhin an Organisatoren, Mitorganisierer und Referenten (intern und extern) gesendet.