Supprimer une extension d’ouverture
Espace de noms: microsoft.graph
Supprimez une extension d’ouverture (objet openTypeExtension) à partir de l’instance spécifiée d’une ressource.
Pour obtenir la liste des ressources qui prennent en charge les extensions ouvertes, consultez le tableau dans la section Autorisations .
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
Selon la ressource à partir de laquelle vous supprimez l’extension et le type d’autorisation (délégué ou application) demandé, l’autorisation spécifiée dans le tableau suivant est la moins privilégiée requise pour appeler cette API. Pour en savoir plus, notamment sur les Mesures de prudence avant de choisir des autorisations plus privilégiées, recherchez ces autorisations dans Autorisations.
| Ressource prise en charge | Déléguée (compte professionnel ou scolaire) | Déléguée (compte Microsoft personnel) | Application |
|---|---|---|---|
| appareil | Directory.AccessAsUser.All | Non pris en charge | Device.ReadWrite.All |
| event | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
| group | Group.ReadWrite.All | Non pris en charge | Group.ReadWrite.All |
| group event | Group.ReadWrite.All | Non pris en charge | Non pris en charge |
| group post | Group.ReadWrite.All | Non pris en charge | Group.ReadWrite.All |
| message | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
| organization | Organization.ReadWrite.All | Non pris en charge | Organization.ReadWrite.All |
| personal 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 |
Requête HTTP
Dans la demande, identifiez l’instance de la ressource, utilisez la propriété de navigation extensions de cette instance pour identifier l’extension et effectuez une DELETE sur cette instance d’extension.
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}
Note: La syntaxe précédente montre quelques méthodes courantes pour identifier une ressource instance, afin de supprimer une extension de celle-ci. Toute autre syntaxe qui vous permet d’identifier ces instances de ressources prend en charge la suppression des extensions ouvertes de celles-ci de la même manière.
Paramètres du chemin d’accès
| Paramètre | Type | Description |
|---|---|---|
| extensionId | Chaîne | Il peut s’agir d’un nom d’extension qui est un identificateur de texte unique pour l’extension, ou d’un nom complet qui concatène le type d’extension et l’identificateur de texte unique. Le nom complet est renvoyé dans la propriété id lorsque vous créez l’extension. Obligatoire. |
| id | Chaîne | Identificateur unique pour une instance dans la collection correspondante. Obligatoire. |
En-têtes de demande
| Nom | Valeur |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 204 No Content. Il ne retourne rien dans le corps de la réponse.
Exemple
Demande
Le premier exemple fait référence à une extension par son nom et supprime l’extension dans le message spécifié.
DELETE https://graph.microsoft.com/v1.0/me/messages/AAMkAGE1M2IyNGNmLTI5MTktNDUyZi1iOTVl===/extensions/Com.Contoso.Referral
Le deuxième exemple supprime une extension dans l’événement de groupe spécifié.
DELETE https://graph.microsoft.com/v1.0/groups/f5480dfd-7d77-4d0b-ba2e-3391953cc74a/events/AAMkADVlN17IsAAA=/extensions/Com.Contoso.Referral
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 204 No Content