名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注意
この機能を baseTask または baseTaskList と共に使用する既存のアプリは、これらのリソースに基づいて構築された To Do API セットが 2022 年 5 月 31 日に非推奨になったので、更新する必要があります。 その API セットは、2022 年 8 月 31 日にデータを戻すことを停止します。
todoTask 上に構築された API セットを使用してください。
指定されたリソースのインスタンスからオープン拡張機能 (openTypeExtension オブジェクト) を削除します。
開いている拡張機能をサポートするリソースの一覧については、「 アクセス許可」 セクションの表を参照してください。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス |
米国政府機関 L4 |
米国政府機関 L5 (DOD) |
21Vianet が運営する中国 |
| ✅ |
✅ |
✅ |
❌ |
アクセス許可
拡張機能を削除するリソースと、要求されたアクセス許可の種類 (委任またはアプリケーション) に応じて、次の表で指定されているアクセス許可は、この API を呼び出すために必要な最小限の特権です。 より多くの特権アクセス許可を選択する前に注意することを含め、詳細については、[アクセス許可] で次のアクセス許可を検索してください。
| サポートされているリソース |
委任 (職場または学校のアカウント) |
委任 (個人用 Microsoft アカウント) |
アプリケーション |
|
device |
Directory.AccessAsUser.All |
サポートされていません。 |
Device.ReadWrite.All |
|
driveItem |
Files.ReadWrite |
Files.ReadWrite |
サポートされていません。 |
|
イベント |
Calendars.ReadWrite |
Calendars.ReadWrite |
Calendars.ReadWrite |
|
グループ |
Group.ReadWrite.All |
サポートされていません。 |
Group.ReadWrite.All |
|
グループ イベント |
Group.ReadWrite.All |
サポートされていません。 |
非サポート |
|
グループの投稿 |
Group.ReadWrite.All |
サポートされていません。 |
Group.ReadWrite.All |
|
メッセージ |
Mail.ReadWrite |
Mail.ReadWrite |
Mail.ReadWrite |
|
メモ |
ShortNotes.ReadWrite |
ShortNotes.ReadWrite |
ShortNotes.ReadWrite.All |
|
organization |
Organization.ReadWrite.All |
サポートされていません。 |
Organization.ReadWrite.All |
|
個人用連絡先 |
Contacts.ReadWrite |
Contacts.ReadWrite |
Contacts.ReadWrite |
|
site |
Sites.ReadWrite.All |
サポートされていません。 |
サポートされていません。 |
|
todoTask |
Tasks.ReadWrite |
Tasks.ReadWrite |
Tasks.ReadWrite.All |
|
todoTasklist |
Tasks.ReadWrite |
Tasks.ReadWrite |
Tasks.ReadWrite.All |
|
ユーザー |
User.ReadWrite |
サポートされていません。 |
User.ReadWrite.All |
|
baseTask (非推奨) |
Tasks.ReadWrite |
Tasks.ReadWrite |
Tasks.ReadWrite.All |
|
baseTasklist (非推奨) |
Tasks.ReadWrite |
Tasks.ReadWrite |
Tasks.ReadWrite.All |
HTTP 要求
要求で、リソース インスタンスを識別し、そのインスタンスの extensions ナビゲーション プロパティを使用して拡張機能を識別し、その拡張インスタンスで DELETE を行います。
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}
メモ： 前の構文は、リソース インスタンスから拡張機能を削除するために、リソース インスタンスを識別するための一般的な方法をいくつか示しています。
こうしたリソース インスタンスを特定するために使用できる他の構文すべても、同様の方法でオープン拡張機能を削除できます。
| 名前 |
値 |
| Authorization |
ベアラー {token}。 必須です。
認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 204 No Content 応答コードを返します。 応答本文では何も返されません。
例
要求 1
最初の例では、名前で拡張情報を参照し、指定されたメッセージの拡張情報を削除します。
DELETE https://graph.microsoft.com/beta/me/messages/AAMkAGE1M2IyNGNmLTI5MTktNDUyZi1iOTVl===/extensions/Com.Contoso.Referral/
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Me.Messages["{message-id}"].Extensions["{extension-id}"].DeleteAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Me().Messages().ByMessageId("message-id").Extensions().ByExtensionId("extension-id").Delete(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
graphClient.me().messages().byMessageId("{message-id}").extensions().byExtensionId("{extension-id}").delete();
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/me/messages/AAMkAGE1M2IyNGNmLTI5MTktNDUyZi1iOTVl===/extensions/Com.Contoso.Referral/')
.version('beta')
.delete();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$graphServiceClient->me()->messages()->byMessageId('message-id')->extensions()->byExtensionId('extension-id')->delete()->wait();
Import-Module Microsoft.Graph.Beta.Mail
# A UPN can also be used as -UserId.
Remove-MgBetaUserMessageExtension -UserId $userId -MessageId $messageId -ExtensionId $extensionId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
await graph_client.me.messages.by_message_id('message-id').extensions.by_extension_id('extension-id').delete()
応答 1
次の例は応答を示しています。
HTTP/1.1 204 No Content
要求 2
2 番目の例では、指定されたグループ イベントの拡張機能を削除します。
DELETE https://graph.microsoft.com/beta/groups/f5480dfd-7d77-4d0b-ba2e-3391953cc74a/events/AAMkADVlN17IsAAA=/extensions/Com.Contoso.Referral
応答 2
次の例は応答を示しています。
HTTP/1.1 204 No Content
要求 3
次の例は、指定した driveItem からその名前で拡張機能を削除する方法を示しています。
DELETE https://graph.microsoft.com/beta/drive/items/01FWCEC553UUOHTOAGBVE2IXBQTIZY3JZQ/extensions/Com.Contoso.Referral
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Extensions["{extension-id}"].DeleteAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Extensions().ByExtensionId("extension-id").Delete(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").extensions().byExtensionId("{extension-id}").delete();
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/drive/items/01FWCEC553UUOHTOAGBVE2IXBQTIZY3JZQ/extensions/Com.Contoso.Referral')
.version('beta')
.delete();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->extensions()->byExtensionId('extension-id')->delete()->wait();
Import-Module Microsoft.Graph.Beta.Files
Remove-MgBetaDriveItemExtension -DriveId $driveId -DriveItemId $driveItemId -ExtensionId $extensionId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').extensions.by_extension_id('extension-id').delete()
応答 3
次の例は応答を示しています。
HTTP/1.1 204 No Content
要求 4
次の例は、指定した サイトから拡張機能を名前で削除する方法を示しています。
DELETE https://graph.microsoft.com/beta/sites/8f52f9ad-4f4f-4739-b682-7c0283207937/extensions/Com.Contoso.Referral
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Sites["{site-id}"].Extensions["{extension-id}"].DeleteAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Sites().BySiteId("site-id").Extensions().ByExtensionId("extension-id").Delete(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
graphClient.sites().bySiteId("{site-id}").extensions().byExtensionId("{extension-id}").delete();
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/sites/8f52f9ad-4f4f-4739-b682-7c0283207937/extensions/Com.Contoso.Referral')
.version('beta')
.delete();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$graphServiceClient->sites()->bySiteId('site-id')->extensions()->byExtensionId('extension-id')->delete()->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
await graph_client.sites.by_site_id('site-id').extensions.by_extension_id('extension-id').delete()
応答 4
次の例は応答を示しています。
HTTP/1.1 204 No Content