管理敏感 Teams 会议的水印

本文介绍如何使用 Microsoft Graph 中的云通信 API 来管理敏感 Microsoft Teams 会议的水印选项。 有关使用此功能的水印会议功能、许可和策略要求的说明，请参阅 敏感 Teams 会议需要水印。

onlineMeeting 资源包含 watermarkProtection 属性，用于指示敏感 Teams 会议的水印选项。

使用以下 REST 调用来管理敏感 Teams 会议的水印保护。

使用水印选项创建联机会议

以下示例显示了为新的 onlineMeeting 配置的水印属性。 有关如何创建联机会议的更多详细信息，请参阅 创建 onlineMeeting。

请求

POST /me/onlineMeetings

{
  "subject": "meeting",
  "startDateTime": "2022-07-01T22:57:47.6388574Z",
  "endDateTime": "2022-07-01T23:57:47.6388574Z",
  "watermarkProtection": {
    "isEnabledForContentSharing": true,
    "isEnabledForVideo": false
  }
}

响应

HTTP/1.1 200 OK
Content-type: application/json

{
  "subject": "meeting",
  "startDateTime": "2022-07-01T22:57:47.6388574Z",
  "endDateTime": "2022-07-01T23:57:47.6388574Z",
  "watermarkProtection": {
    "isEnabledForContentSharing": true,
    "isEnabledForVideo": false
  },
  ...
}

更新联机会议中的水印选项

以下示例演示如何更新 onlineMeeting 的水印属性。 有关如何更新联机会议的更多详细信息，请参阅 更新 onlineMeeting。

注意

更新水印属性对已启动的会议呼叫没有影响。

请求

PATCH /me/onlineMeetings/{meetingId}

{
   ...
   "watermarkProtection": {
      "isEnabledForContentSharing" : true,
      "isEnabledForVideo" : false
   }
}

响应

HTTP/1.1 200 OK
Content-type: application/json

{
   ...
   "watermarkProtection": {
      "isEnabledForContentSharing" : true,
      "isEnabledForVideo" : false
   }
}

获取联机会议中的水印选项

以下示例演示如何使用其水印属性获取 onlineMeeting 。 有关如何获取联机会议的更多详细信息，请参阅 获取 onlineMeeting。

请求

GET /me/onlineMeetings/{meetingId}

响应

HTTP/1.1 200 OK
Content-type: application/json

{
   ...
   "watermarkProtection": {
      "isEnabledForContentSharing" : true,
      "isEnabledForVideo" : false
   }
}

具有水印选项的会议体验受限

在使用水印 () 启用任一水印选项时，使用 云通信调用 API 的应用程序将得到一个受限 (音频，仅) 媒体体验。

为了指示此受限体验，呼叫名单和列表参与者 API 中的每个参与者都有一个新的 restrictedExperience 属性，该属性将 watermarkProtection 显示为受限媒体体验的原因。

请求

GET https://graph.microsoft.com/beta/communications/calls/{callId}/participants

响应

HTTP/1.1 200 OK
Content-Type: application/json

{
   "value":[
     {
         "@odata.type":"#microsoft.graph.participant",
         "info":{
            "@odata.type":"#microsoft.graph.participantInfo",
            "identity":{
               "@odata.type":"#microsoft.graph.identitySet",
               "user":{
                  "@odata.type":"#microsoft.graph.identity",
                  "id":"f2fa86af-3c51-4bc2-8fc0-475452d9764f",
                  "displayName":"Organizer"
               }
            },
         },
         "id":"14319a53-bae8-4129-9cf1-9619ab278b28",
         "metadata":null,
         "restrictedExperience": {
          "videoDisabled": "watermarkProtection"
         }
      },
      {
         "@odata.type":"#microsoft.graph.participant",
         "info":{
            "@odata.type":"#microsoft.graph.participantInfo",
            "identity":{
               "@odata.type":"#microsoft.graph.identitySet",
               "guest":{
                  "@odata.type":"#microsoft.graph.identity",
                  "id":"9714e06e-8c29-4703-8e89-9c3cdaa56391",
                  "displayName":"AnonymousUser1"
               }
            },
         },
         "id":"a7ebfb2d-871e-419c-87af-27290b22e8db",
         "metadata":null,
          "restrictedExperience": {
          "videoDisabled": "watermarkProtection"
         }
      },
      {
         "@odata.type":"#microsoft.graph.participant",
         "info":{
            "@odata.type":"#microsoft.graph.participantInfo",
            "identity":{
               "@odata.type":"#microsoft.graph.identitySet",
               "guest":{
                  "@odata.type":"#microsoft.graph.identity",
                  "id":"38ef1c9d-6a01-4bc2-b5aa-5535952298f7",
                  "displayName":"AnonymousUser2"
               }
            },
         },
         "id":"b35e843e-7771-478a-9dde-2dfed177bfe0",
         "metadata":null,
          "restrictedExperience": {
            "videoDisabled": "watermarkProtection"
         }
      }
   ],
   "@odata.context":"https://graph.microsoft.com/beta/$metadata#communications/calls{callId}/participants"
}