フィードバック 編集

onlineMeeting の更新

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

指定した onlineMeeting オブジェクトのプロパティを更新 します。

更新を サポートするプロパティの 一覧については、「要求本文」セクションを参照してください。

アクセス許可

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) OnlineMeetings.ReadWrite
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション OnlineMeetings.ReadWrite.All

この API でアプリケーションのアクセス許可を使用するには、テナント管理者がアプリケーション アクセス ポリシーを作成し、そのユーザーに代わってオンライン会議を更新するようにポリシーで構成されたアプリを承認するようにユーザーに付与する必要があります (要求パスにユーザー ID が指定されている)。

HTTP 要求

委任された ( ) とアプリ ( ) のアクセス許可を持つ会議 ID を使用して、指定された onlineMeeting /me /users/{userId}/ を更新するには、次のコマンドを実行します。

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

注意

要求ヘッダー

名前 説明
Authorization ベアラー {token}。必須。
Content-type application/json. Required.

要求本文

次の表に、更新できるプロパティの一覧を示します。 要求本文には、更新が必要なプロパティのみを含めて、次の例外を除く。

  • オンライン会議の開始日時または終了日時を更新するには、常に要求本文の startDateTime プロパティと endDateTime プロパティの両方が必要です。
  • participants プロパティ の 開催 者フィールドを更新できません。 会議の作成後、会議の開催者を変更することはできません。
  • 出席者を会議に 追加 または削除するなどの、 参加者 プロパティの出席者フィールドを更新するには、常に要求本文の出席者の完全なリストが必要です。

最後の列は、進行中の会議でこのプロパティの更新が有効かどうかを示します。

プロパティ 型 説明 進行中の会議に適用されますか?
startDateTime DateTime UTC での会議の開始時刻。 いいえ
endDateTime DateTime UTC での会議の終了時刻。 いいえ
subject String オンライン会議の件名。 いいえ
participants meetingParticipants オンライン会議に関連付けられた参加者。 出席者のみを更新できます。 いいえ
isEntryExitAnnounced Boolean 発信者が参加または退出するときにアナウンスするかどうかを指定します。 はい
lobbyBypassSettings lobbyBypassSettings 会議ロビーをバイパスできる参加者を指定します。 はい
allowedPresenters onlineMeetingPresenters 会議の発表者にできるユーザーを指定します。 はい
allowAttendeeToEnableCamera Boolean 出席者がカメラをオンにできるかどうかを示します。 はい
allowAttendeeToEnableMic Boolean 出席者がマイクをオンにできるかどうかを示します。 はい
allowMeetingChat meetingChatMode 会議チャットのモードを指定します。 はい
allowTeamworkReactions Boolean 会議でTeamsを有効にするかどうかを示します。 はい

注意

  • allowedPresenters および allowMeetingChat で使用できる値の一覧については 、「onlineMeeting」を参照してください。
  • allowedPresenters の値を更新する場合は、指定された出席者の役割が要求本文に設定された出席者の完全なリスト roleIsPresenter presenter を含みます。

応答

成功した場合、このメソッドは応答コードと、応答本文で 200 OK 更新された onlineMeeting オブジェクトを返します。

例

例 1: startDateTime、endDateTime、subject を更新する

要求

注: 会議 ID は読みやすさのために短縮されました。

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

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

例 2: lobbyBypassSettings を更新する

注: 会議 ID は読みやすさのために短縮されました。

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

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

応答

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