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.
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.
Enthält Informationen zu einer Besprechung, einschließlich der URL, die für die Teilnahme an einer Besprechung verwendet wird, der Teilnehmerliste und der Beschreibung.
Diese Ressource unterstützt das Abonnieren von Änderungsbenachrichtigungen. Weitere Informationen finden Sie unter Abonnieren von Onlinebesprechungen.
Erbt von onlineMeetingBase.
Achtung
Microsoft Graph-Onlinebesprechungs-APIs, die Microsoft Teams-Liveereignisse unterstützen, sind veraltet und geben am 30. September 2024 keine Daten mehr zurück. Neue Microsoft Graph-APIs werden diese APIs im Frühjahr 2025 ersetzen. Weitere Informationen finden Sie unter Einstellung der Teams-Liveereignis-API in Microsoft Graph.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Create | onlineMeeting | Erstellen sie eine Onlinebesprechung. |
| Get | onlineMeeting | Liest die Eigenschaften und Beziehungen eines onlineMeeting-Objekts . |
| Update | onlineMeeting | Aktualisieren sie die Eigenschaften eines onlineMeeting-Objekts . |
| Löschen | Keine | Löschen sie ein onlineMeeting-Objekt . |
| Erstellen oder Abrufen | onlineMeeting | Erstellen Sie eine Onlinebesprechung mit einer benutzerdefinierten, externen ID. Wenn die Besprechung bereits vorhanden ist, rufen Sie ihre Eigenschaften ab. |
| Aufzeichnungen auflisten | callRecording-Sammlung | Rufen Sie die Liste der callRecording-Objekte ab, die einem onlineMeeting zugeordnet sind. |
| Auflisten von Transkripten | callTranscript-Auflistung | Ruft die Liste der Transkripte eines onlineMeetings ab. |
Hinweis
- Ein Bearertoken ist für den
AuthorizationHeader für alle in der vorherigen Tabelle aufgeführten Methoden erforderlich. Ausführliche Informationen zum Abrufen destokenfür denAuthorizationHeader finden Sie unter Abrufen des Zugriffs im Namen eines Benutzers. - Die Ablaufzeit für Onlinebesprechungen wird auf 60 Tage nach der Start- oder Endzeit der Besprechung festgelegt. Wenn die Besprechung vor ablaufen aktualisiert oder aktiviert wird, verlängert sich die Ablaufzeit um weitere 60 Tage.
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| allowAttendeeToEnableCamera | Boolean | Gibt an, ob Teilnehmer ihre Kamera einschalten können. Geerbt von onlineMeetingBase. |
| allowAttendeeToEnableMic | Boolean | Gibt an, ob Teilnehmer ihr Mikrofon einschalten können. Geerbt von onlineMeetingBase. |
| allowBreakoutRooms | Boolean | Gibt an, ob Gruppenräume für die Besprechung aktiviert sind. Geerbt von onlineMeetingBase. |
| allowCopyingAndSharingMeetingContent | Boolean | Gibt an, ob das Kopieren und Freigeben von Besprechungsinhalten für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. |
| allowedLobbyAdmitters | allowedLobbyAdmitterRoles | Gibt die Benutzer an, die über den Wartebereich zugelassen werden können. Die möglichen Werte sind: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue. Geerbt von onlineMeetingBase. |
| allowedPresenters | onlineMeetingPresenters | Gibt an, wer Referent in einer Besprechung sein kann. Mögliche Werte sind: everyone, organization, roleIsPresenter, organizer, unknownFutureValue. Geerbt von onlineMeetingBase. |
| allowLiveShare | meetingLiveShareOptions | Gibt an, ob live share für die Besprechung aktiviert ist. Die möglichen Werte sind: enabled, disabled, unknownFutureValue. Geerbt von onlineMeetingBase. |
| allowMeetingChat | meetingChatMode | Gibt den Modus des Besprechungschats an. Mögliche Werte sind: enabled, disabled, limited, unknownFutureValue. Geerbt von onlineMeetingBase. |
| allowParticipantsToChangeName | Boolean | Gibt an, ob Teilnehmer sich in einem instance der Besprechung umbenennen dürfen. |
| allowPowerPointSharing | Boolean | Gibt an, ob PowerPoint Live für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. |
| allowRecording | Boolean | Gibt an, ob die Aufzeichnung für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. |
| allowTeamworkReactions | Boolean | Gibt an, ob Teams-Reaktionen für die Besprechung aktiviert sind. Geerbt von onlineMeetingBase. |
| allowTranscription | Boolean | Gibt an, ob die Transkription für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. |
| allowWhiteboard | Boolean | Gibt an, ob whiteboard für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. |
| anonymizeIdentityForRoles | onlineMeetingRole-Sammlung | Gibt an, wessen Identität in der Besprechung anonymisiert wird. Die möglichen Werte sind: attendee. Der attendee Wert kann nach dem Hinzufügen nicht über einen PATCH-Vorgang entfernt werden. Geerbt von onlineMeetingBase. |
| audioConferencing | audioConferencing | Die Informationen zum Telefonzugriff (Einwahl) für eine Onlinebesprechung. Schreibgeschützt. Geerbt von onlineMeetingBase. |
| chatInfo | chatInfo | Die Chatinformationen, die dieser Onlinebesprechung zugeordnet sind. Geerbt von onlineMeetingBase. |
| chatRestrictions | chatRestrictions | Gibt die Konfigurationseinstellungen für Besprechungschateinschränkungen an. Geerbt von onlineMeetingBase. |
| creationDateTime | DateTime | Die Erstellungszeit der Besprechung in UTC. Schreibgeschützt. |
| endDateTime | DateTime | Die Endzeit der Besprechung in UTC. Erforderlich, wenn Sie eine Onlinebesprechung erstellen. |
| expiryDateTime | DateTimeOffset | Gibt das Datum und die Uhrzeit des Ablaufs der Besprechungsressource an. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Geerbt von onlineMeetingBase. |
| externalId | Zeichenfolge | Die externe ID, die ein benutzerdefinierter Bezeichner ist. Optional. |
| id | Zeichenfolge | Die Standard-ID, die der Onlinebesprechung zugeordnet ist. Schreibgeschützt. Geerbt von onlineMeetingBase. |
| isEndToEndEncryptionEnabled | Boolean | Gibt an, ob die End-to-End-Verschlüsselung (E2EE) für die Onlinebesprechung aktiviert ist. Geerbt von onlineMeetingBase. |
| isEntryExitAnnounced | Boolean | Gibt an, ob angekündigt werden soll, wann Anrufer beitreten oder diese verlassen. Geerbt von onlineMeetingBase. |
| joinInformation | itemBody | Die Joininformationen in der Sprache und Gebietsschemavariante, die im HTTP-Header der Accept-Language-Anforderung angegeben sind. Schreibgeschützt. Geerbt von onlineMeetingBase. |
| joinMeetingIdSettings | joinMeetingIdSettings | Gibt die joinMeetingId, die Besprechungskennung und die Anforderung für die Kennung an. Nachdem ein onlineMeeting erstellt wurde, können die joinMeetingIdSettings nicht mehr geändert werden. Um Änderungen an dieser Eigenschaft vornehmen zu können, muss die Besprechung abgebrochen und eine neue besprechung erstellt werden. Geerbt von onlineMeetingBase. |
| joinWebUrl | Zeichenfolge | Die Teilnahme-URL der Onlinebesprechung. Das Format der URL kann sich ändern. Benutzer sollten sich daher nicht auf Informationen verlassen, die aus der Analyse der URL extrahiert wurden. Schreibgeschützt. Geerbt von onlineMeetingBase. |
| lobbyBypassSettings | lobbyBypassSettings | Gibt an, welche Teilnehmer den Besprechungslobby umgehen können. Geerbt von onlineMeetingBase. |
| meetingOptionsWebUrl | Zeichenfolge | Stellt die URL zur Seite Teams-Besprechungsoptionen für die angegebene Besprechung bereit. Über diesen Link kann nur der Organisator Besprechungseinstellungen konfigurieren. Geerbt von onlineMeetingBase. |
| meetingSpokenLanguageTag | Zeichenfolge | Gibt die gesprochene Sprache an, die während der Besprechung für Aufzeichnungs- und Transkriptionszwecke verwendet wird. Geerbt von onlineMeetingBase. |
| meetingTemplateId | Zeichenfolge | Die ID der Besprechungsvorlage. |
| participants | meetingParticipants | Die Teilnehmer, die der Onlinebesprechung zugeordnet sind, einschließlich des Organisators und der Teilnehmer. |
| recordAutomatisch | Boolean | Gibt an, ob die Besprechung automatisch erfasst werden soll. Geerbt von onlineMeetingBase. |
| sensitivityLabelAssignment | onlineMeetingSensitivityLabelAssignment | Gibt die Vertraulichkeitsbezeichnung an, die auf die Teams-Besprechung angewendet wird. |
| startDateTime | DateTime | Die Startzeit der Besprechung in UTC. Erforderlich, wenn Sie eine Onlinebesprechung erstellen. |
| shareMeetingChatHistoryDefault | meetingChatHistoryDefaultMode | Gibt an, ob der Besprechungschatverlauf für Teilnehmer freigegeben wird. Die möglichen Werte sind: all, none, unknownFutureValue. Geerbt von onlineMeetingBase. |
| subject | Zeichenfolge | Das Thema der Onlinebesprechung. Geerbt von onlineMeetingBase. |
| videoTeleconferenceId | Zeichenfolge | Die Videotelekonferenz-ID. Schreibgeschützt. Geerbt von onlineMeetingBase. |
| watermarkProtection | watermarkProtectionValues | Gibt an, ob die Clientanwendung ein Wasserzeichen auf einen Inhaltstyp anwenden soll. Geerbt von onlineMeetingBase. |
| alternativeRecording (veraltet) | Stream | Der Inhaltsstream der alternativen Aufzeichnung eines Microsoft Teams-Liveereignisses. Schreibgeschützt. |
| attendeeReport (veraltet) | Stream | Der Inhaltsstream des Teilnehmerberichts eines Teams-Liveereignisses. Schreibgeschützt. |
| autoAdmittedUsers (veraltet) | Zeichenfolge | Die Einstellung, die den Typ der Teilnehmer angibt, die automatisch zur Onlinebesprechung zugelassen werden. Mögliche Werte sind: everyone, everyoneInSameAndFederatedCompany, everyoneInCompany, invitedUsersInCompany, organizer. Schreibgeschützt. |
| broadcastSettings (veraltet) | broadcastMeetingSettings | Einstellungen im Zusammenhang mit einem Liveereignis. |
| Funktionen (veraltet) | meetingCapabilities-Sammlung | Die Liste der Besprechungsfunktionen. Die möglichen Werte sind: questionAndAnswer,unknownFutureValue. |
| isBroadcast (veraltet) | Boolean | Gibt an, ob es sich bei diesem Ereignis um ein Teams-Liveereignis handelt. |
| Aufzeichnung (veraltet) | Stream | Der Inhaltsstream der Aufzeichnung eines Teams-Liveereignisses. Schreibgeschützt. |
Achtung
- Die autoAdmittedUsers-Eigenschaft ist veraltet. Verwenden Sie stattdessen die scope-Eigenschaft von lobbyBypassSettings.
- Die Capabilities-Eigenschaft ist veraltet. Verwenden Sie stattdessen die eigenschaft isQuestionAndAnswerEnabled von broadcastMeetingSettings .
meetingChatHistoryDefaultMode-Werte
| Wert | Beschreibung |
|---|---|
| alle | Der gesamte Besprechungschatverlauf wird freigegeben. |
| keine | Es wird kein Besprechungschatverlauf freigegeben. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
meetingChatMode-Werte
| Wert | Beschreibung |
|---|---|
| aktiviert | Besprechungschat ist aktiviert. |
| deaktiviert | Besprechungschat ist deaktiviert. |
| begrenzt | Der Besprechungschat ist aktiviert, aber nur während des Besprechungsanrufs. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
meetingLiveShareOptions-Werte
| Wert | Beschreibung |
|---|---|
| aktiviert | Livefreigabe für Besprechungen ist aktiviert. |
| deaktiviert | Livefreigabe für Besprechungen ist deaktiviert. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
onlineMeetingPresenters-Werte
| Wert | Beschreibung |
|---|---|
| jeder | Jeder ist ein Referent. Standard. |
| Organisation | Jeder in der organization des Organisators ist ein Referent. |
| roleIsPresenter | Nur die Teilnehmer, deren Rolle Referent ist, sind Referenten. |
| organizer | Nur der Organisator ist ein Referent. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
Tipp
Wenn Sie eine Onlinebesprechung erstellen oder aktualisieren, bei der allowedPresenters auf roleIsPresenterfestgelegt ist, fügen Sie eine vollständige Liste von Teilnehmern ein, deren Rolle im Anforderungstext auf presenter festgelegt ist.
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| aiInsights | callAiInsight-Sammlung | Die KI-Erkenntnisse, die für eine Onlinebesprechung generiert werden. Schreibgeschützt. |
| attendanceReports | meetingAttendanceReport-Sammlung | Die Anwesenheitsberichte einer Onlinebesprechung. Schreibgeschützt. Geerbt von onlineMeetingBase. |
| Aufnahmen | callRecording-Sammlung | Die Aufzeichnungen einer Onlinebesprechung. Schreibgeschützt. |
| Abschriften | callTranscript-Auflistung | Die Transkripte einer Onlinebesprechung. Schreibgeschützt. |
| meetingAttendanceReport (veraltet) | meetingAttendanceReport | Der Anwesenheitsbericht der letzten Onlinebesprechungssitzung. Schreibgeschützt. |
| Registrierung (veraltet) | meetingRegistration | Die Registrierung, die für eine Onlinebesprechung aktiviert ist. Für eine Onlinebesprechung kann nur eine Registrierung aktiviert sein. |
Tipp
- Die eigenschaft meetingAttendanceReport ist veraltet. Es bleibt aus Gründen der Abwärtskompatibilität in der Betaversion. Verwenden Sie in Zukunft die attendanceReports-Eigenschaft , um Anwesenheitsberichte einer Onlinebesprechung abzurufen.
- Die Registrierungseigenschaft ist veraltet und gibt am 12. Dezember 2024 keine Daten mehr zurück. Verwenden Sie die neuen Webinar-APIs. Weitere Informationen finden Sie unter Veraltete Beta-APIs für die Microsoft Graph-Besprechungsregistrierung.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"allowAttendeeToEnableCamera": "Boolean",
"allowAttendeeToEnableMic": "Boolean",
"allowBreakoutRooms": "Boolean",
"allowCopyingAndSharingMeetingContent": "Boolean",
"allowedLobbyAdmitters": "String",
"allowedPresenters": "String",
"allowLiveShare": "String",
"allowMeetingChat": "String",
"allowParticipantsToChangeName": "Boolean",
"allowPowerPointSharing": "Boolean",
"allowRecording": "Boolean",
"allowTeamworkReactions": "Boolean",
"allowTranscription": "Boolean",
"allowWhiteboard": "Boolean",
"anonymizeIdentityForRoles": ["String"],
"audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"},
"chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
"chatRestrictions":{"@odata.type": "microsoft.graph.chatRestrictions"},
"creationDateTime": "String (timestamp)",
"endDateTime": "String (timestamp)",
"expiryDateTime": "String (timestamp)",
"externalId": "String",
"id": "String (identifier)",
"isEndToEndEncryptionEnabled": "Boolean",
"isEntryExitAnnounced": "Boolean",
"joinInformation": {"@odata.type": "microsoft.graph.itemBody"},
"joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"},
"joinWebUrl": "String",
"lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
"meetingOptionsWebUrl": "String",
"meetingSpokenLanguageTag": "String",
"meetingTemplateId": "String",
"sensitivityLabelAssignment": {
"@odata.type": "microsoft.graph.onlineMeetingSensitivityLabelAssignment"
},
"participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
"recordAutomatically": "Boolean",
"shareMeetingChatHistoryDefault": "String",
"startDateTime": "String (timestamp)",
"subject": "String",
"videoTeleconferenceId": "String",
"watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
}