Aktualisieren von onlineMeeting
Namespace: microsoft.graph
Aktualisieren Sie die Eigenschaften des angegebenen onlineMeeting-Objekts .
Eine Liste der Eigenschaften, die das Aktualisieren unterstützen, finden Sie im Abschnitt Anforderungstext .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
In den folgenden Tabellen sind die Berechtigungen mit den geringsten Berechtigungen aufgeführt, die zum Aufrufen dieser API für jeden unterstützten Ressourcentyp erforderlich sind. Befolgen Sie bewährte Methoden , um Berechtigungen mit den geringsten Berechtigungen anzufordern. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungen für die folgende HTTP-Anforderung:
PATCH /me/onlineMeetings/{meetingId}
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | OnlineMeetings.ReadWrite | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Application | Nicht unterstützt | Nicht unterstützt |
Berechtigungen für die folgende HTTP-Anforderung:
PATCH /users/{userId}/onlineMeetings/{meetingId}
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | OnlineMeetings.ReadWrite | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | OnlineMeetings.ReadWrite.All | Nicht verfügbar. |
Hinweis
Um die Anwendungsberechtigung für diese API zu verwenden, müssen Mandantenadministratoren eine Anwendungszugriffsrichtlinie erstellen und sie einem Benutzer erteilen, um die in der Richtlinie konfigurierte App für die Aktualisierung von Onlinebesprechungen im Namen dieses Benutzers zu autorisieren (mit benutzer-ID, die im Anforderungspfad angegeben ist).
HTTP-Anforderung
So aktualisieren Sie das angegebene onlineMeeting mithilfe der Besprechungs-ID mit delegierter (/me
) und app-Berechtigung (/users/{userId}/
)
PATCH /me/onlineMeetings/{meetingId}
PATCH /users/{userId}/onlineMeetings/{meetingId}
Hinweis
-
userId
ist die Objekt-ID eines Benutzers auf der Seite Microsoft Entra Admin Center > Benutzerverwaltung. Weitere Informationen finden Sie unter Anwendungszugriffsrichtlinie. -
meetingId
ist die ID eines onlineMeeting-Objekts .
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Content-type | application/json. Erforderlich. |
Anforderungstext
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die aktualisiert werden können. Geben Sie im Anforderungstext nur die Werte für Eigenschaften an, die aktualisiert werden sollen, mit den folgenden Ausnahmen:
- Das Anpassen des Start- oder Enddatums/der Endzeit einer Onlinebesprechung erfordert immer sowohl die Eigenschaften startDateTime als auch endDateTime im Anforderungstext.
- Das Organisatorfeld der Eigenschaft teilnehmer kann nicht aktualisiert werden. Der Organisator der Besprechung kann nach dem Erstellen der Besprechung nicht mehr geändert werden.
- Das Anpassen des Teilnehmerfelds der Teilnehmereigenschaft , z. B. das Hinzufügen oder Entfernen eines Teilnehmers zur Besprechung, erfordert immer die vollständige Liste der Teilnehmer im Anforderungstext.
Die letzte Spalte gibt an, ob die Aktualisierung dieser Eigenschaft für eine laufende Besprechung wirksam wird.
Eigenschaft | Typ | Beschreibung | Gilt für laufende Besprechungen? |
---|---|---|---|
allowAttendeeToEnableCamera | Boolesch | Gibt an, ob Teilnehmer ihre Kamera einschalten können. | Ja |
allowAttendeeToEnableMic | Boolesch | Gibt an, ob Teilnehmer ihr Mikrofon einschalten können. | Ja |
allowBreakoutRooms | Boolesch | Gibt an, ob Gruppenräume für die Besprechung aktiviert sind. | Nein |
allowedLobbyAdmitters | allowedLobbyAdmitterRoles | Gibt die Benutzer an, die über den Wartebereich zugelassen werden können. Mögliche Werte sind: organizerAndCoOrganizersAndPresenters , organizerAndCoOrganizers und unknownFutureValue . |
Ja |
allowedPresenters | onlineMeetingPresenters | Gibt an, wer Referent in einer Besprechung sein kann. | Ja |
allowLiveShare | meetingLiveShareOptions | Gibt an, ob live share für die Besprechung aktiviert ist. | Nein |
allowMeetingChat | meetingChatMode | Gibt den Modus des Besprechungschats an. | Ja |
allowPowerPointSharing | Boolesch | Gibt an, ob PowerPoint Live für die Besprechung aktiviert ist. | Nein |
allowRecording | Boolesch | Gibt an, ob die Aufzeichnung für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. | Ja |
allowTeamworkReactions | Boolesch | Gibt an, ob Teams-Reaktionen für die Besprechung aktiviert sind. | Ja |
allowTranscription | Boolesch | Gibt an, ob die Transkription für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. | Ja |
allowWhiteboard | Boolesch | Gibt an, ob whiteboard für die Besprechung aktiviert ist. | Nein |
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. |
Nein |
endDateTime | DateTime | Die Endzeit der Besprechung in UTC. | Nein |
isEntryExitAnnounced | Boolesch | Gibt an, ob angekündigt werden soll, wann Anrufer beitreten oder diese verlassen. | Ja |
lobbyBypassSettings | lobbyBypassSettings | Gibt an, welche Teilnehmer den Besprechungslobby umgehen können. | Ja |
participants | meetingParticipants | Die Teilnehmer, die der Onlinebesprechung zugeordnet sind. Nur Teilnehmer können aktualisiert werden. | Nein |
recordAutomatisch | Boolesch | Gibt an, ob die Besprechung automatisch erfasst werden soll. | Nein |
startDateTime | DateTime | Die Startzeit der Besprechung in UTC. | Nein |
subject | Zeichenfolge | Das Thema der Onlinebesprechung. | Nein |
watermarkProtection | watermarkProtectionValues | Gibt an, ob die Clientanwendung ein Wasserzeichen auf einen Inhaltstyp anwenden soll. Geerbt von onlineMeetingBase. Geerbt von onlineMeetingBase. | Nein |
broadcastSettings (veraltet) | broadcastMeetingSettings | Einstellungen im Zusammenhang mit einem Liveereignis. | Nein |
Hinweis
- Eine Liste der möglichen Werte für allowedPresenters, allowLiveShare und allowMeetingChat finden Sie unter onlineMeeting.
- Wenn Sie den Wert von allowedPresenters auf
roleIsPresenter
aktualisieren, fügen Sie im Anforderungstext eine vollständige Liste von Teilnehmern ein, deren Rolle aufpresenter
festgelegt ist.
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK
Antwortcode und ein aktualisiertes onlineMeeting-Objekt im Antworttext zurück.
Beispiele
Beispiel 1: Aktualisieren von startDateTime, endDateTime und subject
Anforderung
Anmerkung: Die Besprechungs-ID wurde aus Gründen der Lesbarkeit gekürzt.
PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json
{
"startDateTime": "2020-09-09T14:33:30.8546353-07:00",
"endDateTime": "2020-09-09T15:03:30.8566356-07:00",
"subject": "Patch Meeting Subject"
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"id":"MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
"creationDateTime":"2020-07-03T00:23:39.444642Z",
"startDateTime":"2020-09-09T21:33:30.8546353Z",
"endDateTime":"2020-09-09T22:03:30.8566356Z",
"joinWebUrl":"url",
"subject":"Patch Meeting Subject",
"isBroadcast":false,
"autoAdmittedUsers":"EveryoneInCompany",
"outerMeetingAutoAdmittedUsers":null,
"participants":{
"organizer":{
"upn":"upn",
"role": "presenter",
"identity":{
"azureApplicationInstance":null,
"applicationInstance":null,
"application":null,
"device":null,
"user":{
"id":"8716745d-77a9-4be3-afff-009e4b81658e",
"displayName":null,
"tenantId":"0823831b-1f1b-424b-b90a-1caa345a742a",
"identityProvider":"AAD"
}
}
}
},
"audioConferencing":{
"conferenceId":"id",
"tollNumber":"+1-900-555-0100",
"tollFreeNumber":"+1-800-555-0100",
"dialinUrl":"url"
}
}
Beispiel 2: Aktualisieren von lobbyBypassSettings
Anmerkung: Die Besprechungs-ID wurde aus Gründen der Lesbarkeit gekürzt.
PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json
{
"lobbyBypassSettings": {
"isDialInBypassEnabled": true
}
}
Antwort
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
"creationDateTime":"2020-07-03T00:23:39.444642Z",
"startDateTime":"2020-09-09T21:33:30.8546353Z",
"endDateTime":"2020-09-09T22:03:30.8566356Z",
"joinWebUrl":"(redacted)",
"subject":"Patch Meeting Subject",
"autoAdmittedUsers": "EveryoneInCompany",
"isEntryExitAnnounced": true,
"allowedPresenters": "everyone",
"videoTeleconferenceId": "(redacted)",
"participants": {
"organizer": {
"upn": "(redacted)",
"role": "presenter",
"identity": {
"user": {
"id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
"displayName": null,
"tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
"identityProvider": "AAD"
}
}
},
"attendees": [],
},
"lobbyBypassSettings": {
"scope": "organization",
"isDialInBypassEnabled": true
}
}