Удаление открытого расширения
Пространство имен: microsoft.graph
Удаление открытого расширения (объекта openTypeExtension) из указанного экземпляра ресурса.
Список ресурсов, поддерживающих открытые расширения, см. в таблице раздела Разрешения .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
В зависимости от ресурса, из который вы удаляете расширение, и типа запрошенного разрешения (делегированного или приложения), разрешение, указанное в следующей таблице, является наименее привилегированным, необходимым для вызова этого API. Чтобы получить дополнительные сведения, в том числе о соблюдении осторожности перед выбором разрешений с повышенными привилегиями, найдите следующие разрешения в разделе Разрешения.
| Поддерживаемый ресурс | Делегированное (рабочая или учебная учетная запись) | Делегированное (личная учетная запись Майкрософт) | Для приложений |
|---|---|---|---|
| device | Directory.AccessAsUser.All | Не поддерживается | Device.ReadWrite.All |
| event | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
| group | Group.ReadWrite.All | Не поддерживается | Group.ReadWrite.All |
| event для групп | Group.ReadWrite.All | Не поддерживается | Не поддерживается |
| post для групп | Group.ReadWrite.All | Не поддерживается | Group.ReadWrite.All |
| message | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
| organization | Organization.ReadWrite.All | Не поддерживается | Organization.ReadWrite.All |
| contact (личный контакт) | Contacts.ReadWrite | Contacts.ReadWrite | Contacts.ReadWrite |
| todoTask | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
| todoTasklist | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
| user | User.ReadWrite | User.ReadWrite | User.ReadWrite.All |
HTTP-запрос
В запросе идентифицируйте экземпляр ресурса, воспользуйтесь свойством навигации extensions этого экземпляра, чтобы определить расширение, и укажите метод DELETE для этого экземпляра расширения.
DELETE /devices/{Id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/events/{id}/extensions/{extensionId}
DELETE /groups/{id}/extensions/{extensionId}
DELETE /groups/{id}/events/{id}/extensions/{extensionId}
DELETE /groups/{id}/threads/{id}/posts/{id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/messages/{id}/extensions/{extensionId}
DELETE /organization/{Id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/contacts/{id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/extensions/{extensionId}
DELETE /me/todo/lists/{todoTaskListId}/extensions/{extensionId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
DELETE /users/{userId}/todo/lists/{todoTaskListId}/extensions/{extensionId}
DELETE /users/{userId}/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/extensions/{extensionId}
DELETE /me/extensions/{extensionId}
Примечание: В предыдущем синтаксисе показаны некоторые распространенные способы идентификации экземпляра ресурса, чтобы удалить из него расширение. Все остальные синтаксисы, позволяющие идентифицировать эти экземпляры ресурсов, поддерживают удаление открытых расширений из них аналогичным образом.
Параметры пути
| Параметр | Тип | Описание |
|---|---|---|
| extensionId | String | Это может быть имя расширения, которое является уникальным текстовым идентификатором для расширения, или полное имя, которое объединяет тип расширения и уникальный текстовый идентификатор. Полное имя возвращается в свойстве id при создании расширения. Обязательный. |
| id | String | Уникальный идентификатор экземпляра в соответствующей коллекции. Обязательный. |
Заголовки запросов
| Имя | Значение |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
В случае успешного выполнения этот метод возвращает код отклика 204 No Content. Он не возвращает ничего в теле ответа.
Пример
Запрос
В первом примере показано, как сослаться на расширение по его имени и удалить расширение в указанном сообщении.
DELETE https://graph.microsoft.com/v1.0/me/messages/AAMkAGE1M2IyNGNmLTI5MTktNDUyZi1iOTVl===/extensions/Com.Contoso.Referral
Во втором примере показано, как удалить расширение в событии указанной группы.
DELETE https://graph.microsoft.com/v1.0/groups/f5480dfd-7d77-4d0b-ba2e-3391953cc74a/events/AAMkADVlN17IsAAA=/extensions/Com.Contoso.Referral
Отклик
Ниже приводится пример отклика.
HTTP/1.1 204 No Content