Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Criar um novo objeto personAnnotation no perfil de um utilizador.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | User.ReadWrite | AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | User.ReadWrite | Indisponível. |
| Aplicativo | Sem suporte. | Sem suporte. |
Solicitação HTTP
POST /me/profile/notes
POST /users/{id | userPrincipalName}/profile/notes
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json. Obrigatório. |
Corpo da solicitação
No corpo do pedido, forneça uma representação JSON do objeto personAnnotation .
A tabela seguinte mostra as propriedades que são possíveis de definir num novo objeto personAnnotation no perfil de um utilizador.
| Propriedade | Tipo | Descrição |
|---|---|---|
| allowedAudiences | Cadeia de caracteres | As audiências que conseguem ver os valores contidos na entidade. Herdado do itemFacet. Os valores possíveis são: me, , contactsfamily, , organizationgroupMembers, federatedOrganizations, , . unknownFutureValueeveryone |
| detalhe | itemBody | Contém os detalhes da própria nota. |
| displayName | Cadeia de caracteres | Contém um nome amigável para a nota. |
| inferência | inferenceData | Contém detalhes de inferência se a entidade for inferida pela aplicação de criação ou modificação. Herdado do itemFacet. |
| source | personDataSource | Onde os valores tiveram origem se forem sincronizados a partir de outro serviço. Herdado do itemFacet. |
Resposta
Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto personAnnotation no corpo da resposta.
Exemplos
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"
}
Resposta
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
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"
}