Eliminar openTypeExtension
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Precaución
Las aplicaciones existentes que usan esta característica con baseTask o baseTaskList deben actualizarse, ya que el conjunto de API de tareas pendientes basado en estos recursos está en desuso a partir del 31 de mayo de 2022. Ese conjunto de API dejará de devolver datos el 31 de agosto de 2022. Use el conjunto de API basado en todoTask.
Elimina una extensión abierta (objeto openTypeExtension) de la instancia especificada de un recurso.
Para obtener la lista de recursos que admiten extensiones abiertas, consulte la tabla de la sección Permisos .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissions
Según el recurso del que va a eliminar la extensión y el tipo de permiso (delegado o aplicación) solicitado, el permiso especificado en la tabla siguiente es el mínimo privilegio necesario para llamar a esta API. Para más información, incluida la toma de precauciones antes de elegir permisos con más privilegios, busque los siguientes permisos en Permisos.
| Recurso admitido | Delegado (cuenta profesional o educativa) | Delegado (cuenta de Microsoft personal) | Aplicación |
|---|---|---|---|
| baseTask (en desuso) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
| baseTasklist (en desuso) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
| dispositivo | Directory.AccessAsUser.All | No admitido | Device.ReadWrite.All |
| evento | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
| grupo | Group.ReadWrite.All | No admitido | Group.ReadWrite.All |
| evento de grupo | Group.ReadWrite.All | No admitido | No admitido |
| publicación de grupo | Group.ReadWrite.All | No admitido | Group.ReadWrite.All |
| mensaje | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
| organization | Organization.ReadWrite.All | No se admite | Organization.ReadWrite.All |
| contacto personal | Contacts.ReadWrite | Contacts.ReadWrite | Contacts.ReadWrite |
| todoTask | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
| todoTasklist | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
| usuario | User.ReadWrite | User.ReadWrite | User.ReadWrite.All |
Solicitud HTTP
En la solicitud, identifique la instancia de recurso, utilice la propiedad de navegación extensiones de esa instancia para identificar y realizar un DELETE en esa instancia de extensión.
DELETE /administrativeUnits/{administrativeUnitId}/extensions/{extensionId}
DELETE /devices/{deviceId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/events/{eventId}/extensions/{extensionId}
DELETE /groups/{groupId}/extensions/{extensionId}
DELETE /groups/{groupId}/events/{eventId}/extensions/{extensionId}
DELETE /groups/{groupId}/threads/{threadIid}/posts/{postId}/extensions/{extensionId}
DELETE /users/{userIid|userPrincipalName}/messages/{messageId}/extensions/{extensionId}
DELETE /organization/{organizationId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/contacts/{contactId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/extensions/{extensionId}
DELETE /users/me/todo/lists/{listId}/extensions/{extensionId}
DELETE /users/me/todo/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
DELETE /users/me/tasks/lists/{listId}/extensions/{extensionId}
DELETE /users/me/tasks/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
Nota: La sintaxis anterior muestra algunas formas comunes de identificar una instancia de recurso para eliminar una extensión de ella. El resto de la sintaxis que permite identificar estas instancias de recursos admite la eliminación de extensiones abiertas de ellas de forma similar.
Encabezados de solicitud
| Nombre | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve el código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.
Ejemplo
Solicitud
El primer ejemplo hace referencia a una extensión por su nombre y elimina la extensión en el mensaje especificado.
DELETE https://graph.microsoft.com/beta/me/messages/AAMkAGE1M2IyNGNmLTI5MTktNDUyZi1iOTVl===/extensions/Com.Contoso.Referral/
El segundo ejemplo elimina una extensión en el evento de grupo especificado.
DELETE https://graph.microsoft.com/beta/groups/f5480dfd-7d77-4d0b-ba2e-3391953cc74a/events/AAMkADVlN17IsAAA=/extensions/Com.Contoso.Referral
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de