profilePhoto を更新する

名前空間: microsoft.graph

テナント内の指定した連絡先、グループ、チーム、またはユーザーの写真を更新します。 更新できる写真のサイズは、8 MB 未満である必要があります。

各 REST 要求の合計サイズに対する現在の制限は 4 MB であるため、追加できる写真のサイズも 4 MB に制限されています。 Exchange Online 上の HD 写真でサポートされている寸法は次のとおりです。 48x48, , 64x64, 96x96, 360x360``240x240``432x432``120x120``504x504, , .648x648

この操作には PATCH または PUT のいずれかを使用できます。

メモ： この操作では、ユーザーの職場または学校のメールボックスのみがサポートされ、個人用メールボックスはサポートされません。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

連絡先のプロファイル写真を更新するには

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

グループのプロファイル写真を更新するには

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

チームのプロファイル写真を更新するには

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	TeamSettingsReadWriteAll
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	TeamSettingsReadWriteAll

サインインしているユーザーのプロファイル写真を更新するには

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

注意

1. 組織内の任意のユーザーの写真を更新するには、アプリに User.ReadWrite.All アプリケーションのアクセス許可が必要であり、ユーザーの代わりにではなく、独自の ID でこの API を呼び出す必要があります。 詳細については、「ユーザーなしでアクセスを取得する」を参照してください。 サインインしているユーザーの写真を更新するには、 User.ReadWrite アクセス許可のみが必要です。
2. 現在、アプリケーションのアクセス許可を使用してグループ写真にアクセスする場合に既知の問題があります。
3. 現在、Microsoft Graph APIを使用してユーザーの写真を更新することは、Azure AD B2C テナントではサポートされていません。

HTTP 要求

PATCH /me/photo/$value
PATCH /users/{id | userPrincipalName}/photo/$value
PATCH /groups/{id}/photo/$value
PATCH /me/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PATCH /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value

PUT /me/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value
PUT /groups/{id}/photo/$value
PUT /me/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PUT /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PUT /team/{id}/photo/$value

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {token}。必須。
Content-Type	image/jpeg。必須。

要求本文

要求本文に、写真のバイナリ データを含めます。

応答

成功した場合、このメソッドは 、チーム の200 OK写真を204 No Content更新するための応答コードまたは応答コードを返します。

例

例 1: ユーザーの写真を更新する

要求

要求の例を次に示します。

HTTP

PUT https://graph.microsoft.com/v1.0/me/photo/$value
Content-type: image/jpeg

Binary data for the image

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

using var stream = new System.IO.MemoryStream(Encoding.UTF8.GetBytes(@"Binary data for the image"));

await graphClient.Me.Photo.Content
    .Request()
    .PutAsync(stream);

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

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

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

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

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

byte[] stream = Base64.getDecoder().decode("Binary data for the image");
    graphClient.me().photo().content()
    .buildRequest()
    .put(stream);

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

応答

応答の例を次に示します。

HTTP/1.1 200 OK

例 2: チームの写真を更新する

要求

チームの写真を更新する要求の例を次に示します。

PUT https://graph.microsoft.com/v1.0/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value
Content-type: image/jpeg

Binary data for the image

応答

応答の例を次に示します。

HTTP/1.1 204 No Content