Tipo de recurso orgContact

Namespace: microsoft.graph

Representa um contato organizacional. Os contatos organizacionais são gerenciados pelos administradores de uma organização e são diferentes dos contatos pessoais. Além disso, os contatos organizacionais são sincronizados de diretórios locais ou de Exchange Online e são somente leitura no Microsoft Graph.

Herda de directoryObject.

Esse recurso tem suporte para o uso da consulta delta para controlar adições, exclusões e atualizações incrementais oferecendo uma função delta. Esse recurso é um tipo aberto que permite que outras propriedades sejam passadas.

Methods

Método Tipo de retorno Descrição
Contatos organizacionais
Listar contatos organizacionais orgContact Listar propriedades de contatos organizacionais.
Obter contato organizacional orgContact Ler propriedades e relações de um contato organizacional.
Hierarquia organizacional
Obter gerenciador directoryObject Obtenha o gerente do contato organizacional.
Listar directReports Coleção directoryObject Liste os relatórios diretos do contato organizacional.
Listar memberOf Coleção directoryObject Listar os grupos dos que um contato organizacional é membro.
Listar transitiveMemberOf Coleção directoryObject Liste os grupos dos que um contato organizacional é membro, incluindo grupos em que o contato organizacional está aninhado.
checkMemberGroups Coleção de cadeias de caracteres Verifique se há associação a um grupo.
getMemberGroups Coleção de cadeias de caracteres Retornar todos os grupos dos qual o contato organizacional especificado é membro.
getMemberObjects Coleção de cadeias de caracteres Retorna uma lista de directoryObjects do qual o contato organizacional é membro.

Propriedades

Importante

O uso específico de $filter e o parâmetro de consulta $search é suportado somente quando se usa o cabeçalho ConsistencyLevel definido como eventual e $count. Para obter mais informações, consulte Funcionalidades avançadas de consulta nos objetos de diretório do Microsoft Azure AD.

Propriedade Tipo Descrição
Endereços coleção physicalOfficeAddress Endereços postais para este contato organizacional. Por enquanto, um contato só pode ter um endereço físico.
CompanyName String Nome da empresa à qual este contato organizacional pertence. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
departamento String O nome do departamento no qual o contato funciona. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
displayName String Nome de exibição para este contato organizacional. Suporta $filter (eq, ne, not, ge, le, in, startsWith, e eq em null valores), $search, e $orderBy.
givenName String Nome desse contato organizacional. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
id String Identificador exclusivo para este contato organizacional. Suporta $filter (eq, ne, not, in).
jobTitle String Cargo para este contato organizacional. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
email String O endereço SMTP do contato, por exemplo, "jeff@contoso.onmicrosoft.com". Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
mailNickname String Alias de email (parte do endereço de email pré-pendente do símbolo @) para este contato organizacional. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).
onPremisesLastSyncDateTime DateTimeOffset Data e hora em que esse contato organizacional foi sincronizado pela última vez do AD local. Essas informações de data e hora usam o formato ISO 8601 e estão sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Suporta $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors coleção OnPremisesProvisioningError Lista de erros de provisionamento de sincronização para este contato organizacional. Suporta $filter (eq, not).
onPremisesSyncEnabled Booliano truese esse objeto for sincronizado de um diretório local; false se esse objeto foi originalmente sincronizado de um diretório local, mas não está mais sincronizado e agora é mestre no Exchange; null se esse objeto nunca foi sincronizado de um diretório local (padrão).

Suporte $filter (eq, ne, not, in, e eq no null valores).
telefones Coleção phone Lista de telefones para este contato organizacional. Telefone tipos podem ser móveis, empresariais e businessFax. Somente um de cada tipo pode estar presente na coleção.
proxyAddresses Coleção de cadeias de caracteres Por exemplo: "SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com". O operador any é obrigatório para expressões de filtro em propriedades de vários valores. Dá $filter suporte (eq, not, ge, le, startsWithe contando coleções vazias).
surname String Sobrenome deste contato organizacional. Suporte $filter (eq, ne, not, ge, le, in, startsWith, e eq no null valores).

Relações

Relação Tipo Descrição
directReports Coleção directoryObject Os relatórios diretos do contato. (Os usuários e contatos que têm suas propriedades de gerente definidas para este contato.) Somente leitura. Anulável. Suporta o $expand.
manager directoryObject O usuário ou contato que é o gerente desse contato. Somente leitura. Suporta o $expand.
memberOf Coleção directoryObject Grupos dos qual esse contato é membro. Somente leitura. Anulável. Suporta o $expand.
transitiveMemberOf Coleção directoryObject Grupos dos qual esse contato é membro, incluindo grupos em que o contato está aninhado. Somente leitura. Anulável.

Representação JSON

Veja a seguir uma representação JSON do recurso

{
  "addresses": [{"@odata.type": "microsoft.graph.physicalOfficeAddress"}],
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "jobTitle": "string",
  "mail": "string",
  "mailNickname": "string",
  "onPremisesLastSyncDateTime": "string (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSyncEnabled": true,
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "proxyAddresses": ["string"],
  "surname": "string"
}