Обновление onlineMeeting

Пространство имен: microsoft.graph

Обновите свойства указанного объекта onlineMeeting .

Список свойств, поддерживающих обновление, см. в разделе Текст запроса .

Примечание.

Если вы приглашаете на собрание список контактов из более чем 150 участников, они могут получить доступ к чату только во время собрания. Если некоторые пользователи в списке контактов являются обязательными участниками, а остальные являются необязательными, добавьте их непосредственно в качестве участников. Если вы добавите список контактов, в результате чего чат превышает 1000 человек, вы не сможете добавить список. Дополнительные сведения см. в разделе Чат в собраниях Microsoft Teams.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

В следующих таблицах показаны минимальные разрешения или разрешения, необходимые для вызова этого API для каждого поддерживаемого типа ресурсов. Следуйте рекомендациям , чтобы запросить разрешения с наименьшими привилегиями. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Разрешения для следующего HTTP-запроса:

PATCH /me/onlineMeetings/{meetingId}
Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) OnlineMeetings.ReadWrite Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Не поддерживается. Не поддерживается.

Разрешения для следующего HTTP-запроса:

PATCH /users/{userId}/onlineMeetings/{meetingId}
Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) OnlineMeetings.ReadWrite Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений OnlineMeetings.ReadWrite.All Недоступно.

Примечание.

Чтобы использовать разрешение приложения для этого API, администраторы клиентов должны создать политику доступа к приложениям и предоставить ее пользователю, чтобы авторизовать приложение, настроенное в политике, для обновления собраний по сети от имени этого пользователя (с идентификатором пользователя, указанным в пути запроса).

HTTP-запрос

Чтобы обновить указанный onlineMeeting с помощью идентификатора собрания с делегированным разрешением (/me) и приложения (/users/{userId}/), выполните следующие действия:

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

Примечание.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

В следующей таблице перечислены свойства, которые можно обновить. В тексте запроса укажите только значения свойств, которые следует обновить, за следующими исключениями:

  • Для настройки даты и времени начала или окончания собрания по сети всегда требуются свойства startDateTime и endDateTime в тексте запроса.
  • Не удается обновить поле организатора свойства участников . Организатор собрания не может быть изменен после создания собрания.
  • Для настройки поля участников свойства участников , например добавления или удаления участника собрания, всегда требуется полный список участников в тексте запроса.

Последний столбец указывает, вступит ли в силу обновление этого свойства для текущего собрания.

Свойство Тип Описание Применяется к проводимым собраниям?
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 Указывает, чье удостоверение является анонимным в собрании. Возможные значения: attendee. После attendee добавления значение нельзя удалить с помощью операции PATCH. Наследуется от onlineMeetingBase. Нет
endDateTime DateTime Время окончания собрания в формате UTC. Нет
isEndToEndEncryptionEnabled Логический Указывает, включено ли комплексное шифрование (E2EE) для собрания. Нет
isEntryExitAnnounced Логический Следует ли объявлять о том, когда вызывающие присоединяются или покидают ее. Да
lobbyBypassSettings lobbyBypassSettings Указывает, какие участники могут обходить вестибюль собрания. Да
meetingSpokenLanguageTag String Указывает разговорный язык, используемый во время собрания для записи и транскрибирования. Нет
participants meetingParticipants Участники, связанные с собранием по сети. Обновлять можно только участников. Нет
recordAutomatically Логический Указывает, следует ли записывать собрание автоматически. Нет
sensitivityLabelAssignment onlineMeetingSensitivityLabelAssignment Указывает метку конфиденциальности, применяемую к собранию Teams. Нет
startDateTime DateTime Время начала собрания в формате UTC. Нет
subject String Тема онлайн-собрания. Нет
watermarkProtection watermarkProtectionValues Указывает, должно ли клиентское приложение применять водяной знак к типу контента. Наследуется от onlineMeetingBase. Наследуется от onlineMeetingBase. Нет
broadcastSettings (не рекомендуется) broadcastMeetingSettings Параметры, связанные с трансляцией. Нет

Примечание.

  • Список возможных значений для allowedPresenters, allowLiveShare и allowMeetingChat см. в разделе onlineMeeting.
  • При обновлении значения allowedPresenters до roleIsPresenterдобавьте в текст запроса полный список участников с заданной ролью участников, для которых задано значение presenter .

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код ответа и обновленный объект onlineMeeting в теле отклика.

Примеры

Пример 1. Обновление startDateTime, endDateTime и subject

Запрос

Примечание: Идентификатор собрания сокращен для удобства чтения.

PATCH https://graph.microsoft.com/v1.0/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",
  "meetingSpokenLanguageTag": "en-US"
}

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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"
            }
         }
      }
   },
    "sensitivityLabelAssignment": {
      "sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
    },
    "meetingSpokenLanguageTag": "en-US",
    "audioConferencing":{
      "conferenceId":"id",
      "tollNumber":"+1-900-555-0100",
      "tollFreeNumber":"+1-800-555-0100",
      "dialinUrl":"url"
   }
}

Пример 2. Обновление объекта lobbyBypassSettings

Примечание: Идентификатор собрания сокращен для удобства чтения.

PATCH https://graph.microsoft.com/v1.0/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": [],
    },
    "sensitivityLabelAssignment": {
      "sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
    },
    "meetingSpokenLanguageTag": "en-US",
    "lobbyBypassSettings": {
        "scope": "organization",
        "isDialInBypassEnabled": true
    }
}

Пример 3. Включение сквозного шифрования для существующего собрания по сети

В следующем примере показано, как включить сквозное шифрование для существующего собрания по сети.

Примечание: Свойство isEndToEndEncryptionEnabled должно использоваться с политиками Teams для определения окончательного поведения, а применение обновлений политики может занять до 24 часов. Дополнительные сведения см. в разделе Требование сквозного шифрования для конфиденциальных собраний Teams.

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/v1.0/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": []
  },
  "sensitivityLabelAssignment": {
    "sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
  },
  "meetingSpokenLanguageTag": "en-US",
  "lobbyBypassSettings": {
    "scope": "organization",
    "isDialInBypassEnabled": true
  }
}