オープン拡張機能を削除するDelete open extension

指定されたリソースのインスタンスからオープン拡張機能 (openTypeExtension オブジェクト) を削除します。Delete an open extension (openTypeExtension object) from the specified instance of a resource.

アクセス許可Permissions

拡張機能を削除するリソースと、要求されたアクセス許可の種類 (委任またはアプリケーション) に応じて、次の表で指定されているアクセス許可は、この API を呼び出すために必要な最低限の特権です。Depending on the resource you're deleting the extension from and the permission type (delegated or application) requested, the permission specified in the following table is the least privileged required to call this API. アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。To learn more, including how to choose permissions, see Permissions.

サポートされているリソースSupported resource 委任 (職場または学校のアカウント)Delegated (work or school account) 委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) アプリケーションApplication
devicedevice Directory.AccessAsUser.AllDirectory.AccessAsUser.All サポートされていませんNot supported Device.ReadWrite.AllDevice.ReadWrite.All
イベントevent Calendars.ReadWriteCalendars.ReadWrite Calendars.ReadWriteCalendars.ReadWrite Calendars.ReadWriteCalendars.ReadWrite
グループgroup Group.ReadWrite.AllGroup.ReadWrite.All サポート対象外Not supported Group.ReadWrite.AllGroup.ReadWrite.All
グループ イベントgroup event Group.ReadWrite.AllGroup.ReadWrite.All サポート対象外Not supported 非サポートNot supported
グループの投稿group post Group.ReadWrite.AllGroup.ReadWrite.All サポート対象外Not supported Group.ReadWrite.AllGroup.ReadWrite.All
メッセージmessage Mail.ReadWriteMail.ReadWrite Mail.ReadWriteMail.ReadWrite Mail.ReadWriteMail.ReadWrite
組織organization Directory.AccessAsUser.AllDirectory.AccessAsUser.All サポートされていません。Not supported 非サポートNot supported
個人用連絡先personal contact Contacts.ReadWriteContacts.ReadWrite Contacts.ReadWriteContacts.ReadWrite Contacts.ReadWriteContacts.ReadWrite
useruser User.ReadWrite.AllUser.ReadWrite.All User.ReadWriteUser.ReadWrite User.ReadWrite.AllUser.ReadWrite.All

HTTP 要求HTTP request

要求で、リソース インスタンスを識別し、そのインスタンスの extensions ナビゲーション プロパティを使用して拡張機能を識別し、その拡張インスタンスで DELETE を行います。In the request, identify the resource instance, use the extensions navigation property of that instance to identify the extension, and do a DELETE on that extension instance.

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}

注: 上記の構文は、拡張機能の削除元となるリソース インスタンスを特定する一般的な方法を示しています。こうしたリソース インスタンスを特定するために使用できる他の構文すべても、同様の方法でオープン拡張機能を削除できます。Note: The above syntax shows some common ways to identify a resource instance, in order to delete an extension from it. All other syntax that allows you to identify these resource instances supports deleting open extensions from them in a similar way.

パス パラメーターPath parameters

パラメーターParameter Type 説明Description
idid stringstring 対応するコレクションのインスタンスの一意識別子。必須。A unique identifier for an instance in the corresponding collection. Required.
extensionIdextensionId stringstring これは、拡張情報の一意のテキスト識別子である拡張情報名、または拡張情報の種類と一意のテキスト識別子を連結した完全修飾名になります。完全修飾名は、拡張情報を作成したときに、id プロパティで返されます。必須。This can be an extension name which is a unique text identifier for the extension, or a fully qualified name which concatenates the extension type and unique text identifier. The fully qualified name is returned in the id property when you create the extension. Required.

要求ヘッダーRequest headers

名前Name Value
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.

要求本文Request body

このメソッドには、要求本文を指定しません。Do not supply a request body for this method.

応答Response

成功した場合、このメソッドは 204 No Content 応答コードを返します。応答本文には何も返されません。If successful, this method returns 204 No Content response code. It does not return anything in the response body.

Example

要求Request

最初の例では、名前で拡張情報を参照し、指定されたメッセージの拡張情報を削除します。The first example references an extension by its name and deletes the extension in the specified message.

DELETE https://graph.microsoft.com/v1.0/me/messages/AAMkAGE1M2IyNGNmLTI5MTktNDUyZi1iOTVl===/extensions/Com.Contoso.Referral

2 番目の例では、指定されたグループ イベントの拡張機能を削除します。The second example deletes an extension in the specified group event.

DELETE https://graph.microsoft.com/v1.0/groups/f5480dfd-7d77-4d0b-ba2e-3391953cc74a/events/AAMkADVlN17IsAAA=/extensions/Com.Contoso.Referral

SDK サンプルコードSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

await graphClient.Me.Messages["AAMkAGE1M2IyNGNmLTI5MTktNDUyZi1iOTVl==="].Extensions["Com.Contoso.Referral"]
    .Request()
    .DeleteAsync();

SDK をプロジェクトに追加し、 authproviderインスタンスを作成する方法の詳細については、 sdk のドキュメントを参照してください。Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

応答Response

以下は、応答の例です。Here is an example of the response.

HTTP/1.1 204 No Content