onlineMeeting を更新する

  • [アーティクル]

名前空間: microsoft.graph

重要

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

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

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

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ❌ ❌ ❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) OnlineMeetings.ReadWrite 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション サポートされていません。 サポートされていません。

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

HTTP 要求

委任された () アクセス許可とアプリ/users/{userId}/ (/me) アクセス許可を持つ会議 ID を使用して、指定された onlineMeeting を更新するには:

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

注:

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Content-type application/json. 必須です。

要求本文

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

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

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

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

注:

  • allowedPresenters と allowMeetingChat の使用可能な値の一覧については、「onlineMeeting」を参照してください。
  • allowedPresenters の値を にroleIsPresenter更新する場合は、指定した出席者のロールが に設定presenterされている出席者の完全なリストを要求本文に含めます。

応答

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

例

例 1: startDateTime、endDateTime、件名を更新する

要求

メモ： 読みやすくするために、会議 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
    }
}