Обновление профиляФото
Пространство имен: microsoft.graph
Обновите фотографию указанного контакта, группы, команды или пользователя в клиенте. Размер фотографии, до который можно обновить, ограничен 4 МБ.
Для этой операции можно использовать PATCH или PUT.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
В следующих таблицах показаны минимальные разрешения или разрешения, необходимые для вызова этого API для каждого поддерживаемого типа ресурсов. Следуйте рекомендациям , чтобы запросить разрешения с наименьшими привилегиями. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Обновление фотографии профиля контакта
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | Contacts.ReadWrite | Не поддерживается. |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Для приложений | Contacts.ReadWrite | Не поддерживается. |
Обновление фотографии профиля группы
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
Обновление фото профиля команды
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | TeamSettings.ReadWrite.All | Не поддерживается. |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Для приложений | Не поддерживается. | Не поддерживается. |
Обновление фото профиля пользователя
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | ProfilePhoto.ReadWrite.All | User.ReadWrite, User.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | User.ReadWrite | Не поддерживается. |
Приложение | ProfilePhoto.ReadWrite.All | User.ReadWrite.All |
Примечание.
- Пользователи с такими ролями администратора, как администраторы пользователей, могут обновлять фотографии любого пользователя в организации с помощью делегированных разрешений. Эта операция также поддерживается с разрешениями приложения. Для обновления фотографии любого пользователя в организации требуется разрешение ProfilePhoto.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