Atualizar personResponsibility

Namespace: microsoft.graph

Atualize as propriedades de um objeto personResponsibility no perfil de um usuário.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All
Delegada (conta pessoal da Microsoft) User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All
Aplicativo User.ReadBasic.All, User.Read.All, User.ReadWrite.All

Solicitação HTTP

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON do objeto personResponsibility.

A tabela a seguir mostra as propriedades que são necessárias ao criar a personResponsibility.

Propriedade Tipo Descrição
allowedAudiences Cadeia de caracteres As audiências que são capazes de ver os valores contidos na entidade. Herdado do itemFacet. Os valores possíveis são: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
collaborationTags Coleção de cadeias de caracteres Contém marcas de cenário de experiência que um usuário associou aos juros. Os valores permitidos na coleção são: askMeAbout ableToMentor , , , wantsToLearn wantsToImprove .
description Cadeia de caracteres Descrição da responsabilidade.
displayName Cadeia de caracteres Contém um nome amigável para a responsabilidade.
inferência inferenceData Contém detalhes de inferência se a entidade for inferida pelo aplicativo de criação ou modificação. Herdado do itemFacet.
webUrl String Contém um link para uma página da Web ou recurso sobre a responsabilidade.

Resposta

Se tiver êxito, este método retornará um código de resposta e um 200 OK objeto personResponsibility atualizado no corpo da resposta.

Exemplos

Solicitação

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

{
  "collaborationTags": [
    "askMeAbout"
  ]
}

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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