Обновление virtualAppointment (не рекомендуется)
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Предостережение
Ресурс virtualAppointment и вспомогательные методы являются устаревшими и не будут возвращать данные 30 июня 2023 г. Мы рекомендуем обновить существующие приложения, использующие этот API, чтобы использовать новую функцию get join link .
Обновите свойства объекта virtualAppointment .
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | OnlineMeetings.ReadWrite | Недоступно. |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Для приложений | Не поддерживается. | Не поддерживается. |
Примечание.
Виртуальная встреча будет переходить с разрешений на собрания по сети на более конкретные виртуальные встречи в течение периода предварительной версии. Это даст разработчикам более детальный контроль над разрешениями на виртуальные встречи. Мы укажем дополнительные сведения о том, когда разрешения на собрания по сети больше не будут поддерживаться до окончания периода предварительной версии.
HTTP-запрос
PATCH /me/onlineMeetings/{onlineMeetingId}/virtualAppointment
PATCH /users/{userId}/onlineMeetings/{onlineMeetingId}/virtualAppointment
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Принять-Язык | Язык. Необязательное. |
Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите только значения свойств для обновления. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.
В следующей таблице указаны свойства, которые можно обновить.
Свойство | Тип | Описание |
---|---|---|
appointmentClients | коллекция virtualAppointmentUser | Сведения о клиенте для виртуальной встречи, включая имя, адрес электронной почты и номер телефона SMS. Необязательный параметр. |
appointmentClientJoinWebUrl | String | URL-адрес присоединения виртуальной встречи для клиентов с подключением к комнате ожидания и в браузере. Необязательный параметр. |
externalAppointmentId | String | Идентификатор встречи из системы планирования, связанный с текущей виртуальной встречей. Необязательный параметр. |
externalAppointmentUrl | String | URL-адрес ресурса встречи из системы планирования, связанный с текущей виртуальной встречей. Необязательный параметр. |
settings | virtualAppointmentSettings | Параметры, связанные с ресурсом виртуальной встречи. Необязательный параметр. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 204 No Content
.
Примеры
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi/virtualAppointment
Content-Type: application/json
If-Match: W/"ZfYdV7Meckeip07P//nwjAAADyI7NQ=="
Content-length: 379
{
"@odata.type": "#microsoft.graph.virtualAppointment",
"id": "0c7fda79-ff00-f57f-37e3-28183b6d09b5",
"settings": {
"@odata.type": "microsoft.graph.virtualAppointmentSettings",
"allowClientToJoinUsingBrowser": "true"
},
"appointmentClients": [
{
"@odata.type": "microsoft.graph.virtualAppointmentUser",
"emailAddress": "gradya@contoso.com",
"displayName": "Grady Archie",
"smsCapablePhoneNumber": "123-456-7890"
}
],
"externalAppointmentId": "AAMkADKnAAA=",
"externalAppointmentUrl": "https://anyschedulingsystem.com/api/appointments/MkADKnAAA=",
"appointmentClientJoinWebUrl": "https://visit.teams.microsoft.com/webrtc-svc/api/route?tid=a796be92-&convId=19:meeting_=True"
}
Отклик
Ниже показан пример отклика.
HTTP/1.1 204 No Content
PATCH возвращает ошибку 412 Предварительные условия сбоем, если значение "If-Match" не соответствует "ETag" в виртуальной встрече.