Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Создание нового человекаОбъект аннотации в профиле пользователя.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальное обслуживание | Правительство США L4 | Правительство США L5 (DOD) | Китай, обслуживаемый 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешения с наименьшим объемом привилегий | Разрешения с более высоким уровнем привилегий |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | User.ReadWrite | AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | User.ReadWrite | Недоступно. |
| Для приложений | Не поддерживается. | Не поддерживается. |
HTTP-запрос
POST /me/profile/notes
POST /users/{id | userPrincipalName}/profile/notes
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации. |
| Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите JSON-представление объекта personAnnotation .
В следующей таблице показаны свойства, которые можно настроить в новом объекте personAnnotation в профиле пользователя.
| Свойство | Тип | Описание |
|---|---|---|
| allowedAudiences | String | Аудитории, которые могут видеть значения, содержащиеся в сущности. Наследуется от itemFacet. Возможные значения: me, family, contacts, unknownFutureValuegroupMembersfederatedOrganizationsorganizationeveryone. |
| подробности | itemBody | Содержит сведения о самой заметке. |
| displayName | String | Содержит понятное имя заметки. |
| логический вывод | inferenceData | Содержит подробные сведения о выводе, если объект выводится создающим или изменяющим приложением. Наследуется от itemFacet. |
| source | personDataSource | Источник значений при синхронизации из другой службы. Наследуется от itemFacet. |
Отклик
В случае успеха этот метод возвращает код ответа 201 Created и объект personAnnotation в тексте ответа.
Примеры
POST https://graph.microsoft.com/beta/me/profile/notes
Content-Type: application/json
{
"detail": {
"contentType": "text",
"content": "I am originally from Australia, but grew up in Moscow, Russia."
},
"displayName": "About Me"
}
Отклик
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"detail": {
"contentType": "text",
"content": "I am originally from Australia, but grew up in Moscow, Russia."
},
"displayName": "About Me"
}