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 de versão.

Uma agregação de informações sobre uma pessoa através de email, contatos e redes sociais. As pessoas podem ser contatos locais, contatos de redes sociais, diretório da sua organização e pessoas de comunicações recentes (como email e Skype).

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 coleção rankedEmailAddress Os endereços de email da pessoa.
givenName string O nome fornecido da pessoa.
id string O identificador exclusivo da pessoa. Somente leitura.
isFavorite booliano true se o usuário tiver sinalizado essa pessoa como um favorito.
mailboxType string O tipo de caixa de correio que é representado pelo endereço de email 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 string 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 fontes das quais os dados do usuário são provenientes, por exemplo, contatos do Outlook ou do Outlook.
surname string O sobrenome da pessoa.
title string O título da pessoa.
userPrincipalName string O nome UPN da pessoa. O UPN é um nome de logon para a pessoa ao estilo da Internet com base na RFC 822 padrão da Internet. Por convenção, ele deve ser mapeado para o nome de email da pessoa. O formato geral é alias@domínio.
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

Veja a seguir uma representação JSON do recurso.

{
  "birthday": "string",
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.rankedEmailAddress"}],
  "givenName": "string",
  "id": "string (identifier)",
  "isFavorite": true,
  "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"
}