次の方法で共有

onlineMeeting を更新する

  • [アーティクル]

名前空間: microsoft.graph

重要

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

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

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

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

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

アクセス許可

次の表は、サポートされている各リソースの種類でこの API を呼び出すために必要な最小特権のアクセス許可またはアクセス許可を示しています。 ベスト プラクティスに従って、最小限の特権のアクセス許可を要求します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

次の HTTP 要求のアクセス許可:

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

次の HTTP 要求のアクセス許可:

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

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

HTTP 要求

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

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

注:

要求ヘッダー

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

要求本文

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

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

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

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

注:

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