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 .

Hinweis

Wenn Sie eine Kontaktliste mit mehr als 150 Mitgliedern zu einer Besprechung einladen, können diese nur während der Besprechung auf den Chat zugreifen. Wenn einige Personen in der Kontaktliste erforderliche Teilnehmer sind und der Rest optional ist, fügen Sie sie direkt als Teilnehmer hinzu. Wenn Sie eine Kontaktliste hinzufügen, die dazu führt, dass der Chat 1.000 Personen überschreitet, können Sie die Liste nicht hinzufügen. Weitere Informationen finden Sie unter Chat in Microsoft Teams-Besprechungen.

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 Boolean Gibt an, ob Teilnehmer ihre Kamera einschalten können. Ja
allowAttendeeToEnableMic Boolean Gibt an, ob Teilnehmer ihr Mikrofon einschalten können. Ja
allowBreakoutRooms Boolean Gibt an, ob Gruppenräume für die Besprechung aktiviert sind. Nein
allowCopyingAndSharingMeetingContent Boolean Gibt an, ob die Möglichkeit zum Kopieren und Freigeben von Besprechungsinhalten für die Besprechung aktiviert ist. Ja
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 Boolean Gibt an, ob PowerPoint Live für die Besprechung aktiviert ist. Nein
allowRecording Boolean Gibt an, ob die Aufzeichnung für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. Ja
allowTeamworkReactions Boolean Gibt an, ob Teams-Reaktionen für die Besprechung aktiviert sind. Ja
allowTranscription Boolean Gibt an, ob die Transkription für die Besprechung aktiviert ist. Geerbt von onlineMeetingBase. Ja
allowWhiteboard Boolean 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
isEndToEndEncryptionEnabled Boolean Gibt an, ob die End-to-End-Verschlüsselung (E2EE) für die Besprechung aktiviert ist. Nein
isEntryExitAnnounced Boolean 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 Boolean 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",
   "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
    }
}

Beispiel 3: Aktivieren der End-to-End-Verschlüsselung für eine vorhandene Onlinebesprechung

Das folgende Beispiel zeigt, wie Sie die End-to-End-Verschlüsselung für eine vorhandene Onlinebesprechung aktivieren.

Anmerkung: Die eigenschaft isEndToEncryptionEnabled muss mit Teams-Richtlinien verwendet werden, um das endgültige Verhalten zu bestimmen, und die Anwendung von Richtlinienupdates kann bis zu 24 Stunden dauern. Weitere Informationen finden Sie unter Anfordern der End-to-End-Verschlüsselung für vertrauliche Teams-Besprechungen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json 

{
  "isEndToEndEncryptionEnabled": true
}

Antwort

Das folgende Beispiel zeigt die 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": "(redacted)",
  "subject": "Patch Meeting Subject",
  "autoAdmittedUsers": "EveryoneInCompany",
  "isEndToEndEncryptionEnabled": true,
  "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
  }
}