名前空間: 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 要求のアクセス許可:
PATCH /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}
注:
-
userIdは、ユーザー管理ページのユーザー Microsoft Entra 管理センター >オブジェクト ID です。 詳細については、「 アプリケーション アクセス ポリシー」を参照してください。 -
meetingIdは、onlineMeeting オブジェクトの ID です。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-type | application/json. 必須です。 |
要求本文
次の表に、更新できるプロパティの一覧を示します。 要求本文で、更新する必要があるプロパティの値 のみを 指定しますが、次の例外があります。
- オンライン会議の開始日または終了日時を更新する場合は、要求本文に startDateTime プロパティと endDateTime プロパティの両方を常に含める必要があります。
- participants プロパティの開催者フィールドは更新できません。 会議の作成後、会議の開催者を変更することはできません。
- 会議への出席者の追加や削除など、participants プロパティの [出席者] フィールドを更新する場合は、常に要求本文に出席者の完全な一覧を含める必要があります。
最後の列は、このプロパティの更新が進行中の会議に有効かどうかを示します。
| プロパティ | 型 | 説明 | 進行中の会議に適用されますか? |
|---|---|---|---|
| allowAttendeeToEnableCamera | ブール型 | 出席者がカメラをオンにできるかどうかを示します。 | はい |
| allowAttendeeToEnableMic | ブール型 | 出席者がマイクをオンにできるかどうかを示します。 | はい |
| allowBreakoutRooms | ブール型 | ブレークアウト ルームが会議に対して有効になっているかどうかを示します。 | 不要 |
| allowCopyingAndSharingMeetingContent | ブール型 | 会議のコンテンツのコピーと共有を有効にするかどうかを示します。 | はい |
| allowedLobbyAdmitters | allowedLobbyAdmitterRoles | ロビーから許可できるユーザーを指定します。 使用可能な値: organizerAndCoOrganizersAndPresenters、organizerAndCoOrganizers、unknownFutureValue。 |
はい |
| allowedPresenters | onlineMeetingPresenters | 会議で発表者になることができるユーザーを指定します。 | はい |
| allowLiveShare | meetingLiveShareOptions | 会議のライブ共有が有効かどうかを示します。 | 不要 |
| allowMeetingChat | meetingChatMode | 会議チャットのモードを指定します。 | はい |
| allowPowerPointSharing | ブール型 | 会議PowerPointライブが有効になっているかどうかを示します。 | 不要 |
| allowRecording | ブール型 | 会議の記録が有効かどうかを示します。 onlineMeetingBase から継承されます。 | はい |
| allowTeamworkReactions | ブール型 | 会議で Teams の反応が有効になっているかどうかを示します。 | はい |
| allowTranscription | ブール型 | 会議で文字起こしが有効かどうかを示します。 onlineMeetingBase から継承されます。 | はい |
| allowWhiteboard | ブール型 | 会議でホワイトボードが有効かどうかを示します。 | 不要 |
| anonymizeIdentityForRoles | onlineMeetingRole コレクション | 会議で匿名化される ID を指定します。 使用可能な値は、 attendeeです。
attendee値は、追加後の PATCH 操作では削除できません。
onlineMeetingBase から継承されます。 |
不要 |
| endDateTime | DateTime | 会議の終了時刻 (UTC)。 | 不要 |
| isEndToEndEncryptionEnabled | ブール型 | 会議でエンドツーエンド暗号化 (E2EE) が有効かどうかを示します。 | 不要 |
| isEntryExitAnnounced | ブール型 | 呼び出し元が参加または退出するタイミングをアナウンスするかどうか。 | はい |
| lobbyBypassSettings | lobbyBypassSettings | 会議ロビーをバイパスできる参加者を指定します。 | はい |
| meetingSpokenLanguageTag | 文字列 | 会議中に記録および文字起こしのために使用される音声言語を指定します。 | 不要 |
| participants | meetingParticipants | オンライン会議に関連付けられている参加者。 出席者のみが更新できます。 | 不要 |
| recordAutomatically | ブール型 | 会議を自動的に記録するかどうかを示します。 | 不要 |
| sensitivityLabelAssignment | onlineMeetingSensitivityLabelAssignment | Teams 会議に適用される秘密度ラベルを指定します。 | 不要 |
| startDateTime | DateTime | UTC での会議の開始時刻。 | いいえ |
| subject | 文字列 | オンライン会議の件名。 | 不要 |
| watermarkProtection | watermarkProtectionValues | クライアント アプリケーションがコンテンツ タイプに透かしを適用するかどうかを指定します。 onlineMeetingBase から継承されます。 | 不要 |
| broadcastSettings (非推奨) | broadcastMeetingSettings | ライブ イベントに関連する設定。 | いいえ |
注:
- allowedPresenters、allowLiveShare、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",
"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"
},
"sensitivityLabelAssignment": {
"sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
}
}
例 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
}
}
例 3: 既存のオンライン会議でエンドツーエンドの暗号化を有効にする
次の例は、既存のオンライン会議でエンドツーエンドの暗号化を有効にする方法を示しています。
手記: このプロパティは Teams ポリシーと共に使用して最終的な動作を判断する必要があり、ポリシーの更新が適用されるまでに最大 24 時間かかることがあります。 詳細については、「機密性の 高い Teams 会議にエンドツーエンドの暗号化を要求する」を参照してください。
要求
次の例は要求を示しています。
PATCH https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json
{
"isEndToEndEncryptionEnabled": 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",
"isEndToEndEncryptionEnabled": true,
"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
}
}