Actualizar personResponsibility

Espacio de nombres: microsoft.graph

Actualice las propiedades de un objeto personResponsibility en el perfil de un usuario.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	User.Read	User.Read.All, User.ReadBasic.All, User.ReadWrite, User.ReadWrite.All
Delegado (cuenta personal de Microsoft)	User.Read	User.ReadWrite
Aplicación	No admitida.	No admitida.

Solicitud HTTP

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

Encabezados de solicitud

Nombre	Descripción
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type	application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto personResponsibility .

En la tabla siguiente se enumeran las propiedades necesarias al crear la personResponsibility.

Propiedad	Tipo	Descripción
allowedAudiences	Cadena	Audiencias que pueden ver los valores contenidos en la entidad. Se hereda de itemFacet. Los valores posibles son: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone y unknownFutureValue.
collaborationTags	Colección string	Contiene etiquetas de escenario de experiencia que un usuario ha asociado al interés. Los valores permitidos en la colección son: askMeAbout, ableToMentor, , wantsToLearnwantsToImprove.
description	Cadena	Descripción de la responsabilidad.
displayName	Cadena	Contiene un nombre descriptivo para la responsabilidad.
Inferencia	inferenceData	Contiene detalles de inferencia si la aplicación de creación o modificación deduce la entidad. Se hereda de itemFacet.
webUrl	Cadena	Contiene un vínculo a una página web o un recurso sobre la responsabilidad.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto personResponsibility actualizado en el cuerpo de la respuesta.

Ejemplos

Solicitud

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

{
  "collaborationTags": [
    "askMeAbout"
  ]
}

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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"
  ]
}