Обновление onlineMeeting

  • Статья

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

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

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

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

Разрешения

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

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

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

HTTP-запрос

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

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

Примечание.

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

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

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

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

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

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

Свойство Тип Описание Применяется к проводимым собраниям?
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 и subject

Запрос

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

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

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

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