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 creado a partir de 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. Utilice el conjunto de API creado 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, vea la tabla de la sección Permisos .

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ❌

Permissions

Según el recurso del que vaya a eliminar la extensión y el tipo de permiso (delegado o de aplicación) solicitado, el permiso especificado en la tabla siguiente es el menos privilegiado 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
dispositivo Directory.AccessAsUser.All No admitida. Device.ReadWrite.All
driveItem Files.ReadWrite Files.ReadWrite No admitida.
evento Calendars.ReadWrite Calendars.ReadWrite Calendars.ReadWrite
grupo Group.ReadWrite.All No admitida. Group.ReadWrite.All
evento de grupo Group.ReadWrite.All No admitida. No admitido
publicación de grupo Group.ReadWrite.All No admitida. Group.ReadWrite.All
mensaje Mail.ReadWrite Mail.ReadWrite Mail.ReadWrite
Nota ShortNotes.ReadWrite ShortNotes.ReadWrite ShortNotes.ReadWrite.All
organization Organization.ReadWrite.All No admitida. Organization.ReadWrite.All
contacto personal Contacts.ReadWrite Contacts.ReadWrite Contacts.ReadWrite
site Sites.ReadWrite.All No admitida. No admitida.
todoTask Tasks.ReadWrite Tasks.ReadWrite Tasks.ReadWrite.All
todoTasklist Tasks.ReadWrite Tasks.ReadWrite Tasks.ReadWrite.All
usuario User.ReadWrite No admitida. User.ReadWrite.All
baseTask (obsoleto) Tasks.ReadWrite Tasks.ReadWrite Tasks.ReadWrite.All
baseTasklist (obsoleto) Tasks.ReadWrite Tasks.ReadWrite Tasks.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 /users/{userId|userPrincipalName}/notes/{noteId}/extensions/{extensionId}
DELETE /organization/{organizationId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/contacts/{contactId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/todo/lists/{listId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/todo/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/tasks/lists/{listId}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/tasks/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
DELETE /drive/items/{itemId}/extensions/{extensionId}
DELETE /sites/{site-id}/extensions/{extensionId}

Nota: La sintaxis anterior muestra algunas maneras comunes de identificar una instancia de recursos para eliminar una extensión de ella. Todas las demás sintaxis que permiten identificar estas instancias de recursos admiten 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 autenticación y 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 1

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/

Respuesta 1

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Solicitud 2

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 2

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Solicitud 3

En el ejemplo siguiente se muestra cómo eliminar una extensión por su nombre del elemento de unidad especificado.

DELETE https://graph.microsoft.com/beta/drive/items/01FWCEC553UUOHTOAGBVE2IXBQTIZY3JZQ/extensions/Com.Contoso.Referral

Respuesta 3

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Solicitud 4

En el ejemplo siguiente se muestra cómo eliminar una extensión por su nombre del sitio especificado.

DELETE https://graph.microsoft.com/beta/sites/8f52f9ad-4f4f-4739-b682-7c0283207937/extensions/Com.Contoso.Referral

Respuesta 4

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content
  • Se actualizó por última vez el