Обновление профиляФото

  • Статья

Пространство имен: microsoft.graph

Обновите фотографию указанного контакта, группы, команды или пользователя в клиенте. Размер фотографии, до который можно обновить, ограничен 4 МБ.

Для этой операции можно использовать PATCH или PUT.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

В следующих таблицах показаны минимальные разрешения или разрешения, необходимые для вызова этого API для каждого поддерживаемого типа ресурсов. Следуйте рекомендациям , чтобы запросить разрешения с наименьшими привилегиями. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Обновление фотографии профиля контакта

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Contacts.ReadWrite Не поддерживается.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Contacts.ReadWrite Не поддерживается.

Обновление фотографии профиля группы

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Group.ReadWrite.All Не поддерживается.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Не поддерживается. Не поддерживается.

Обновление фото профиля команды

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) TeamSettings.ReadWrite.All Не поддерживается.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Не поддерживается. Не поддерживается.

Обновление фото профиля пользователя

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) User.ReadWrite User.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений User.ReadWrite.All Не поддерживается.

Примечание.

  • Приложение с разрешениями только приложения не может обновить фотографию группы.
  • Глобальный администратор и администратор пользователей могут обновить фотографию любого пользователя в организации, используя делегированные разрешения. Эта операция также поддерживается с разрешениями приложения. Для обновления фотографии любого пользователя в организации требуется разрешение User.ReadWrite.All . Для обновления фотографии вошедшего пользователя требуется только разрешение User.ReadWrite .
  • Обновление фотографии пользователя с помощью microsoft API Graph в настоящее время не поддерживается в клиентах Azure AD B2C.

HTTP-запрос

Чтобы обновить фото профиля контакта, выполните приведенные ниже действия.

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/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

Чтобы обновить групповую фотографию, выполните приведенные далее действия.

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

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

Чтобы обновить фотографию команды, выполните приведенные далее действия.

PUT /teams/{id}/photo/$value

Чтобы обновить фото профиля пользователя, выполните приведенные ниже действия.

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

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

Заголовки запросов

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type image/jpeg. Обязательно.

Тело запроса

В текст запроса нужно включить двоичные данные фотографии.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код ответа или 204 No Content код ответа для обновления фотографии команды.

Примеры

Пример 1. Обновление фотографии пользователя

Запрос

Ниже показан пример запроса.

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

Binary data for the image

Отклик

Ниже показан пример отклика.

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