連絡先を削除するDelete contact

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

連絡先を削除します。Delete contact.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Contacts.ReadWriteContacts.ReadWrite
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) Contacts.ReadWriteContacts.ReadWrite
アプリケーションApplication Contacts.ReadWriteContacts.ReadWrite

HTTP 要求HTTP request

ユーザーの既定のContactfolderからの連絡先A contact from user's default contactFolder.

DELETE /me/contacts/{id}
DELETE /users/{id | userPrincipalName}/contacts/{id}

ユーザーの最上位レベル contactFolder からの 連絡先A contact from a user's top level contactFolder.

DELETE /me/contactFolders/{id}/contacts/{id}
DELETE /users/{id | userPrincipalName}/contactFolders/{id}/contacts/{id}

contactFolder の子フォルダー内に含まれる 連絡先A contact contained in a child folder of a contactFolder. 次の例は、入れ子のレベルの 1 つを示していますが、連絡先は子の子などに入れることができます。The example below shows one level of nesting, but a contact can be located in a child of a child and so on.

DELETE /me/contactFolder/{id}/childFolders/{id}/.../contacts/{id}
DELETE /users/{id | userPrincipalName}/contactFolders/{id}/childFolders/{id}/contacts/{id}

要求ヘッダーRequest headers

ヘッダーHeader 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

以下は、要求の例です。Here is an example of the request.

DELETE https://graph.microsoft.com/beta/me/contacts/{id}
応答Response

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 204 No Content

SDK サンプルコードSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

await graphClient.Me.Contacts["{id}"]
    .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.