Обновление personОтветственность

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

Обновление свойств объекта personResponsibility в профиле пользователя.

Разрешения

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

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

HTTP-запрос

PATCH /me/responsibilities/{id}
PATCH /users/{id | userPrincipalName}/responsibilities/{id}

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

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type	application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление объекта personResponsibility в формате JSON.

В следующей таблице перечислены свойства, необходимые при создании personResponsibility.

Свойство	Тип	Описание
allowedAudiences	String	Аудитории, которые могут видеть значения, содержащиеся в сущности. Наследуется от itemFacet. Возможные значения: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
метки совместной работы	Коллекция строк	Содержит теги сценария взаимодействия, связанные с интересующим пользователем. Допустимые значения в коллекции: askMeAbout, ableToMentor, wantsToLearn, . wantsToImprove
description	String	Описание ответственности.
displayName	String	Содержит понятное имя для ответственности.
Вывод	inferenceData	Содержит сведения о выводе, если сущность выводится путем создания или изменения приложения. Наследуется от itemFacet.
webUrl	String	Содержит ссылку на веб-страницу или ресурс об ответственности.

Отклик

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

Примеры

Запрос

PATCH https://graph.microsoft.com/beta/me/responsibilities/0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f
Content-Type: application/json

{
  "collaborationTags": [
    "askMeAbout"
  ]
}

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
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"
    }
  },
  "source": null,
  "description": "Member of the Microsoft API Council",
  "displayName": "API Council",
  "webUrl": null,
  "collaborationTags": [
    "askMeAbout"
  ]
}