Freigeben über


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

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 roleIsPresenteraktualisieren, fügen Sie im Anforderungstext eine vollständige Liste von Teilnehmern ein, deren Rolle auf presenter 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
    }
}