Tipo de recurso orgContact

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.

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	coleção orgContact	Listar propriedades de contatos organizacionais.
Obter contato organizacional	orgContact	Ler propriedades e relações do objeto orgContact.
Hierarquia organizacional
Obter gerenciador	directoryObject	Obtenha o gerente do contato.
Get transitiveReports	Inteiro	Obtenha a contagem de relatórios transitivos para um contato da organização da propriedade de navegação transitiveReports.
Listar directReports	Coleção directoryObject	Liste os relatórios diretos do contato.
Listar memberOf	Coleção directoryObject	Obter uma coleção de objetos memberOf.
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 especificado é membro.
checkMemberObjects	Coleção de cadeias de caracteres	Verifique se há associação em grupos, unidades administrativas e funções de diretório.
getMemberObjects	Coleção de cadeias de caracteres	Obtenha a lista de grupos, unidades administrativas e funções de diretório dos que o contato é 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. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está 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	true se esse objeto for sincronizado de um diretório local; false se este objeto foi originalmente sincronizado de um diretório local, mas não está mais sincronizado e agora é mestre no Exchange; nulo se esse objeto nunca tiver sido 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. Suporta $filter (eq, ne, not, in).
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. Suporta $filter (eq, ne, not, ge, le, in, startsWith e eq em valores null)

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.
transitiveReports	Coleção directoryObject	Os relatórios transitivos de um contato. Somente leitura.

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