onlineMeeting-Ressourcentyp
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. |
Auflisten von Transkripten | callTranscript-Auflistung | Ruft die Liste der Transkripte eines onlineMeetings ab. |
Aufzeichnungen auflisten | callRecording-Sammlung | Rufen Sie die Liste der callRecording-Objekte ab, die einem onlineMeeting zugeordnet sind. |
Hinweis
- Ein Bearertoken ist für den
Authorization
Header für alle in der vorherigen Tabelle aufgeführten Methoden erforderlich. Ausführliche Informationen zum Abrufen destoken
für denAuthorization
Header 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 | Boolescher Wert | Gibt an, ob Teilnehmer ihre Kamera einschalten können. Geerbt von onlineMeetingBase. |
allowAttendeeToEnableMic | Boolescher Wert | Gibt an, ob Teilnehmer ihr Mikrofon einschalten können. Geerbt von onlineMeetingBase. |
allowBreakoutRooms | Boolescher Wert | Gibt an, ob Gruppenräume für die Besprechung aktiviert sind. Geerbt von onlineMeetingBase. |
allowedLobbyAdmitters | allowedLobbyAdmitterRoles | Gibt die Benutzer an, die über den Wartebereich zugelassen werden können. Mögliche Werte sind: organizerAndCoOrganizersAndPresenters , organizerAndCoOrganizers und unknownFutureValue . Geerbt von onlineMeetingBase. |
allowedPresenters | onlineMeetingPresenters | Gibt an, wer Referent in einer Besprechung sein kann. Mögliche Werte: everyone , organization , roleIsPresenter , organizer , unknownFutureValue . Geerbt von onlineMeetingBase. |
allowLiveShare | meetingLiveShareOptions | Gibt an, ob live share für die Besprechung aktiviert ist. Mögliche Werte sind: enabled , disabled und unknownFutureValue . Geerbt von onlineMeetingBase. |
allowMeetingChat | meetingChatMode | Gibt den Modus des Besprechungschats an. Mögliche Werte: enabled , disabled , limited , unknownFutureValue Geerbt von onlineMeetingBase. |
allowParticipantsToChangeName | Boolescher Wert | Gibt an, ob Teilnehmer sich in einem instance der Besprechung umbenennen dürfen. |
allowPowerPointSharing | Boolescher Wert | Gibt an, ob PowerPoint Live für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. |
allowRecording | Boolescher Wert | Gibt an, ob die Aufzeichnung für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. |
allowTeamworkReactions | Boolescher Wert | Gibt an, ob Teams-Reaktionen für die Besprechung aktiviert sind. Geerbt von onlineMeetingBase. |
allowTranscription | Boolescher Wert | Gibt an, ob die Transkription für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. |
allowWhiteboard | Boolescher Wert | 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. Mögliche 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. |
externalId | Zeichenfolge | Die externe ID. Eine benutzerdefinierte ID. Optional. |
id | Zeichenfolge | Die Standard-ID, die der Onlinebesprechung zugeordnet ist. Schreibgeschützt. Geerbt von onlineMeetingBase. |
isEntryExitAnnounced | Boolescher Wert | 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. |
meetingTemplateId | Zeichenfolge | Die ID der Besprechungsvorlage. |
participants | meetingParticipants | Die Teilnehmer, die der Onlinebesprechung zugeordnet sind, einschließlich des Organisators und der Teilnehmer. |
recordAutomatisch | Boolescher Wert | Gibt an, ob die Besprechung automatisch erfasst werden soll. Geerbt von onlineMeetingBase. |
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. Mögliche Werte sind: all , none und 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: everyone , everyoneInSameAndFederatedCompany , everyoneInCompany , invitedUsersInCompany , organizer . Schreibgeschützt. |
broadcastSettings (veraltet) | broadcastMeetingSettings | Einstellungen im Zusammenhang mit einem Liveereignis. |
Funktionen (veraltet) | meetingCapabilities-Sammlung | Die Liste der Besprechungsfunktionen. Mögliche Werte: questionAndAnswer ,unknownFutureValue . |
isBroadcast (veraltet) | Boolescher Wert | 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 roleIsPresenter
festgelegt ist, fügen Sie eine vollständige Liste von Teilnehmern ein, deren Rolle im Anforderungstext auf presenter
festgelegt ist.
Beziehungen
Beziehung | Typ | Beschreibung |
---|---|---|
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",
"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)",
"id": "String (identifier)",
"isEntryExitAnnounced": "Boolean",
"joinInformation": {"@odata.type": "microsoft.graph.itemBody"},
"joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"},
"joinWebUrl": "String",
"lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
"meetingTemplateId": "String",
"participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
"recordAutomatically": "Boolean",
"shareMeetingChatHistoryDefault": "String",
"startDateTime": "String (timestamp)",
"subject": "String",
"videoTeleconferenceId": "String",
"watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
}