プロファイルの削除Photo

[アーティクル]
11/15/2023

名前空間: microsoft.graph

サインインしているユーザーまたは指定したグループの写真を削除します。

注:

削除操作では、ユーザーまたはグループの写真のみがサポートされますが、 Outlook の連絡先や Teams の写真はサポートされません。

アクセス許可

次の表は、サポートされている各リソースの種類でこの API を呼び出すために必要な最小特権のアクセス許可またはアクセス許可を示しています。ベストプラクティスに従って、最小限の特権のアクセス許可を要求します。委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。これらのアクセス許可の詳細については、アクセス許可のリファレンスを参照してください。

サインインしているユーザーのプロフィール写真を削除するには

アクセス許可の種類	最小特権アクセス許可	特権の高いアクセス許可
委任 (職場または学校のアカウント)	User.ReadWrite	User.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	User.ReadWrite.All	サポートされていません。

グループのプロフィール写真を削除するには

アクセス許可の種類	最小特権アクセス許可	特権の高いアクセス許可
委任 (職場または学校のアカウント)	Group.ReadWrite.All	サポートされていません。
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	サポートされていません。	サポートされていません。

注:

アプリケーションのアクセス許可のみを持つアプリは、グループの写真を削除できません。
グローバル管理者とユーザー管理者は、委任されたアクセス許可を使用して、organization内の任意のユーザーの写真を削除できます。この操作では、アプリケーションのアクセス許可もサポートされます。 organization内の任意のユーザーの写真を削除するには、User.ReadWrite.All アクセス許可が必要です。サインインしているユーザーの写真を削除するには、 User.ReadWrite アクセス許可のみが必要です。

HTTP 要求

ユーザーのプロフィール写真を削除するには:

DELETE /me/photo/$value
DELETE /users/{id | userPrincipalName}/photo/$value

グループ写真を削除するには:

DELETE /groups/{id}/photo/$value

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {token}。必須です。認証と承認の詳細については、こちらをご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードを返します。

例

要求

次の例は要求を示しています。

HTTP
JavaScript

DELETE https://graph.microsoft.com/v1.0/me/photo/$value


const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/me/photo/$value')
	.delete();

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

次の例は応答を示しています。

HTTP/1.1 200 OK