Tipo de recurso person
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Representa uma agregação de informações sobre uma pessoa de entre e-mails e contactos. As pessoas podem ser contactos locais ou o diretório da sua organização e pessoas de comunicações recentes (como e-mail).
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Listar pessoas | person | Obtém uma coleção de objetos person ordenados por relevância para o usuário. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| birthday | String | O aniversário da pessoa. |
| companyName | String | O nome da empresa da pessoa. |
| departamento | String | O departamento da pessoa. |
| displayName | String | O nome de exibição da pessoa. |
| emailAddresses | rankedEmailAddress collection | Os endereços de email da pessoa. |
| givenName | String | O nome fornecido da pessoa. |
| id | String | O identificador exclusivo da pessoa. Somente leitura. |
| isFavorite | Boolean |
True se o usuário tiver sinalizado essa pessoa como um favorito. |
| mailboxType | Cadeia de caracteres | O tipo de caixa de correio representada pelo endereço de e-mail da pessoa. |
| officeLocation | String | O local do escritório da pessoa. |
| personNotes | String | As anotações de forma livre que o usuário fez sobre essa pessoa. |
| personType | Cadeia de caracteres | O tipo de pessoa, por exemplo, lista de distribuição. |
| telefones | Coleção phone | Os números de telefone da pessoa. |
| postalAddresses | location collection | Os endereços da pessoa. |
| profession | String | A profissão da pessoa. |
| fontes | coleção personDataSource | As origens dos dados de utilizador são provenientes, por exemplo, Contactos do Diretório ou do Outlook. |
| surname | String | O sobrenome da pessoa. |
| title | Cadeia de caracteres | O título da pessoa. |
| userPrincipalName | String | O nome principal de utilizador (UPN) da pessoa. O UPN é um nome de início de sessão ao estilo da Internet para a pessoa com base no RFC 822 padrão da Internet. Por convenção, deve mapear para o nome de e-mail da pessoa. O formato geral é alias@domain. |
| websites | Coleção website | Os sites da pessoa. |
| yomiCompany | String | O nome japonês fonético da empresa da pessoa. |
Relações
Nenhum
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"birthday": "String",
"companyName": "String",
"department": "String",
"displayName": "String",
"emailAddresses": [{"@odata.type": "microsoft.graph.rankedEmailAddress"}],
"givenName": "String",
"id": "String (identifier)",
"isFavorite": "Boolean",
"mailboxType": "String",
"officeLocation": "String",
"personNotes": "String",
"personType": "String",
"phones": [{"@odata.type": "microsoft.graph.phone"}],
"postalAddresses": [{"@odata.type": "microsoft.graph.location"}],
"profession": "String",
"sources": [{"@odata.type": "microsoft.graph.personDataSource"}],
"surname": "String",
"title": "String",
"userPrincipalName": "String",
"websites": [{"@odata.type": "microsoft.graph.website"}],
"yomiCompany": "String"
}