Feedback Bearbeiten

OnlineMeeting aktualisieren

  • Artikel
  • 9 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Dient zum Aktualisieren der Eigenschaften des angegebenen onlineMeeting-Objekts.

Eine Liste der Eigenschaften, die updates unterstützen, finden Sie im Abschnitt "Anforderungstext".

Berechtigungen

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) OnlineMeetings.ReadWrite
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt.
Anwendung OnlineMeetings.ReadWrite.All

Um die Anwendungsberechtigung für diese API zu verwenden, müssen Mandantenadministratoren eine Anwendungzugriffsrichtlinie erstellen und sie einem Benutzer erteilen, um die in der Richtlinie konfigurierte App zu autorisieren, Onlinebesprechungen im Namen dieses Benutzers zu aktualisieren (mit der im Anforderungspfad angegebenen Benutzer-ID).

HTTP-Anforderung

So aktualisieren Sie das angegebene onlineMeeting mithilfe der Besprechungs-ID mit delegierter ( /me ) und App ( ) /users/{userId}/ Berechtigung:

PATCH /me/onlineMeetings/{meetingId}
PATCH /users/{userId}/onlineMeetings/{meetingId}

Hinweis

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich.
Content-type application/json. Erforderlich.

Anforderungstext

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die aktualisiert werden können. Schließen Sie im Anforderungstext nur die Eigenschaften ein, die aktualisiert werden müssen, mit den folgenden Ausnahmen:

  • Zum Aktualisieren des Anfangs- oder Enddatums/der Endzeit einer Onlinebesprechung sind immer sowohl die Eigenschaften "startDateTime" als auch "endDateTime" im Anforderungstext erforderlich.
  • Das Organisatorfeld der Teilnehmereigenschaft kann nicht aktualisiert werden. Der Organisator der Besprechung kann nach dem Erstellen der Besprechung nicht mehr geändert werden.
  • Das Aktualisieren 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 das Aktualisieren dieser Eigenschaft für eine laufende Besprechung wirksam wird.

Eigenschaft Typ Beschreibung Gilt für laufende Besprechungen?
startDateTime DateTime Die Startzeit der Besprechung in UTC. Nein
endDateTime DateTime Die Endzeit der Besprechung in UTC. Nein
subject Zeichenfolge Der Betreff der Onlinebesprechung. Nein
participants meetingParticipants Die mit der Onlinebesprechung verknüpften Teilnehmer. Nur Teilnehmer können aktualisiert werden. Nein
isEntryExitAnnounced Boolean Gibt an, ob angegeben werden soll, wann Anrufer beitreten oder diese verlassen. Ja
lobbyBypassSettings lobbyBypassSettings Gibt an, welche Teilnehmer den Besprechungslobby umgehen können. Ja
allowedPresenters onlineMeetingPresenters Gibt an, wer ein Referent in einer Besprechung sein kann. Ja
allowAttendeeToEnableCamera Boolescher Wert Gibt an, ob Teilnehmer ihre Kamera einschalten können. Ja
allowAttendeeToEnableMic Boolean Gibt an, ob Teilnehmer ihr Mikrofon einschalten können. Ja
allowMeetingChat meetingChatMode Gibt den Modus des Besprechungschats an. Ja
allowTeamworkReactions Boolean Gibt an, ob Teams Reaktionen für die Besprechung aktiviert sind. Ja

Hinweis

  • Eine Liste der möglichen Werte für allowedPresenters und allowMeetingChat finden Sie unter "onlineMeeting".
  • Wenn Sie den Wert von allowedPresenters auf roleIsPresenter aktualisieren, fügen Sie eine vollständige Liste der Teilnehmer mit angegebener Teilnehmerrolle presenter in den Anforderungstext ein.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes onlineMeeting-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Aktualisieren von "startDateTime", "endDateTime" und "subject"

Anforderung

Hinweis: Die Besprechungs-ID wurde zur besseren Lesbarkeit gekürzt.

PATCH https://graph.microsoft.com/beta/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

Hinweis: Die Besprechungs-ID wurde zur besseren Lesbarkeit gekürzt.

PATCH https://graph.microsoft.com/beta/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
    }
}