OnlineMeeting aktualisieren

Artikel
07/18/2022
6 Minuten Lesedauer

Namespace: microsoft.graph

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

userId ist die Objekt-ID eines Benutzers im Azure Benutzerverwaltungsportal. Weitere Informationen finden Sie unter Anwendungszugriffsrichtlinie.
meetingIdist die ID eines onlineMeeting-Objekts.

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 Anpassen des Anfangs- oder Enddatums/der Endzeit einer Onlinebesprechung sind immer die Eigenschaften "startDateTime" und "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 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 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

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"
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var onlineMeeting = new OnlineMeeting
{
    StartDateTime = DateTimeOffset.Parse("2020-09-09T21:33:30.8546353+00:00"),
    EndDateTime = DateTimeOffset.Parse("2020-09-09T22:03:30.8566356+00:00"),
    Subject = "Patch Meeting Subject"
};

await graphClient.Me.OnlineMeetings["{onlineMeeting-id}"]
    .Request()
    .UpdateAsync(onlineMeeting);


const options = {
    authProvider,
};

const client = Client.init(options);

const onlineMeeting = {
  startDateTime: '2020-09-09T14:33:30.8546353-07:00',
  endDateTime: '2020-09-09T15:03:30.8566356-07:00',
  subject: 'Patch Meeting Subject'
};

await client.api('/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi')
    .update(onlineMeeting);


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi"]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphOnlineMeeting *onlineMeeting = [[MSGraphOnlineMeeting alloc] init];
[onlineMeeting setStartDateTime: "2020-09-09T21:33:30.8546353+00:00"];
[onlineMeeting setEndDateTime: "2020-09-09T22:03:30.8566356+00:00"];
[onlineMeeting setSubject:@"Patch Meeting Subject"];

NSError *error;
NSData *onlineMeetingData = [onlineMeeting getSerializedDataWithError:&error];
[urlRequest setHTTPBody:onlineMeetingData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

OnlineMeeting onlineMeeting = new OnlineMeeting();
onlineMeeting.startDateTime = OffsetDateTimeSerializer.deserialize("2020-09-09T21:33:30.8546353+00:00");
onlineMeeting.endDateTime = OffsetDateTimeSerializer.deserialize("2020-09-09T22:03:30.8566356+00:00");
onlineMeeting.subject = "Patch Meeting Subject";

graphClient.me().onlineMeetings("MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi")
    .buildRequest()
    .patch(onlineMeeting);


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewOnlineMeeting()
startDateTime, err := time.Parse(time.RFC3339, "2020-09-09T14:33:30.8546353-07:00")
requestBody.SetStartDateTime(&startDateTime)
endDateTime, err := time.Parse(time.RFC3339, "2020-09-09T15:03:30.8566356-07:00")
requestBody.SetEndDateTime(&endDateTime)
subject := "Patch Meeting Subject"
requestBody.SetSubject(&subject)
onlineMeetingId := "onlineMeeting-id"
graphClient.Me().OnlineMeetingsById(&onlineMeetingId).Patch(requestBody)


Import-Module Microsoft.Graph.CloudCommunications

$params = @{
    StartDateTime = [System.DateTime]::Parse("2020-09-09T14:33:30.8546353-07:00")
    EndDateTime = [System.DateTime]::Parse("2020-09-09T15:03:30.8566356-07:00")
    Subject = "Patch Meeting Subject"
}

# A UPN can also be used as -UserId.
Update-MgUserOnlineMeeting -UserId $userId -OnlineMeetingId $onlineMeetingId -BodyParameter $params

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":"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

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

{
  "lobbyBypassSettings": {
      "isDialInBypassEnabled": true
  }
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var onlineMeeting = new OnlineMeeting
{
    LobbyBypassSettings = new LobbyBypassSettings
    {
        IsDialInBypassEnabled = true
    }
};

await graphClient.Me.OnlineMeetings["{onlineMeeting-id}"]
    .Request()
    .UpdateAsync(onlineMeeting);


const options = {
    authProvider,
};

const client = Client.init(options);

const onlineMeeting = {
  lobbyBypassSettings: {
      isDialInBypassEnabled: true
  }
};

await client.api('/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi')
    .update(onlineMeeting);


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi"]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphOnlineMeeting *onlineMeeting = [[MSGraphOnlineMeeting alloc] init];
MSGraphLobbyBypassSettings *lobbyBypassSettings = [[MSGraphLobbyBypassSettings alloc] init];
[lobbyBypassSettings setIsDialInBypassEnabled: true];
[onlineMeeting setLobbyBypassSettings:lobbyBypassSettings];

NSError *error;
NSData *onlineMeetingData = [onlineMeeting getSerializedDataWithError:&error];
[urlRequest setHTTPBody:onlineMeetingData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

OnlineMeeting onlineMeeting = new OnlineMeeting();
LobbyBypassSettings lobbyBypassSettings = new LobbyBypassSettings();
lobbyBypassSettings.isDialInBypassEnabled = true;
onlineMeeting.lobbyBypassSettings = lobbyBypassSettings;

graphClient.me().onlineMeetings("MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi")
    .buildRequest()
    .patch(onlineMeeting);


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewOnlineMeeting()
lobbyBypassSettings := msgraphsdk.NewLobbyBypassSettings()
requestBody.SetLobbyBypassSettings(lobbyBypassSettings)
isDialInBypassEnabled := true
lobbyBypassSettings.SetIsDialInBypassEnabled(&isDialInBypassEnabled)
onlineMeetingId := "onlineMeeting-id"
graphClient.Me().OnlineMeetingsById(&onlineMeetingId).Patch(requestBody)


Import-Module Microsoft.Graph.CloudCommunications

$params = @{
    LobbyBypassSettings = @{
        IsDialInBypassEnabled = $true
    }
}

# A UPN can also be used as -UserId.
Update-MgUserOnlineMeeting -UserId $userId -OnlineMeetingId $onlineMeetingId -BodyParameter $params

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
    }
}

OnlineMeeting aktualisieren

Berechtigungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiele

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

Anforderung

Antwort

Beispiel 2: Aktualisieren von lobbyBypassSettings

Antwort

Feedback