orgContact resource type

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 um contacto organizacional. Os contactos organizacionais são geridos pelos administradores de uma organização e são diferentes dos contactos pessoais. Além disso, os contactos organizacionais são sincronizados a partir de diretórios no local ou de Exchange Online e são só de 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 org	orgContact collection	Listar propriedades de contactos organizacionais.
Obter contato org	orgContact	Ler propriedades e relações do objeto orgContact.
Hierarquia organizacional
Obter gerenciador	directoryObject	Obtenha o gestor do contacto.
Get transitiveReports	Inteiro	Obtenha a contagem de relatórios transitivos para um contacto da organização a partir da propriedade de navegação transitiveReports.
Listar subordinados diretos	Coleção directoryObject	Listar os relatórios diretos do contacto.
Listar memberOf	Coleção directoryObject	Obter um membroA coleção de objetos.
Verificar grupos de membros	String collection	Verifique a existência de associação a grupos.
Obter grupos de membros	String collection	Devolver todos os grupos dos quais o contacto especificado é membro.
Verificar objetos de membro	Coleção String	Verifique a associação em grupos, unidades administrativas e funções de diretório.
Obter objetos de membros	Coleção String	Obtenha a lista de grupos, unidades administrativas e funções de diretório de que o contacto é 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, veja Capacidades avançadas de consulta em objetos de diretório.

Propriedade	Tipo	Descrição
endereços	coleção physicalOfficeAddress	Endereços postais para este contacto organizacional. Por enquanto, um contacto só pode ter um endereço físico.
CompanyName	String	Nome da empresa à qual este contacto organizacional pertence. $filter Suporta (eq, ne, not, ge, le, in, startsWithe eq para null valores).
department	String	O nome do departamento no qual o contacto funciona. $filter Suporta (eq, ne, not, ge, le, in, startsWithe eq para null valores).
displayName	Cadeia de caracteres	Nome a apresentar para este contacto organizacional. $filter Suporta (eq, ne, not, ge, le, in, startsWithe eq para null valores), $search, e $orderby.
givenName	Cadeia de caracteres	Nome próprio deste contacto organizacional. $filter Suporta (eq, ne, not, ge, le, in, startsWithe eq para null valores).
id	Cadeia de caracteres	Identificador exclusivo para este contacto organizacional. Suporta $filter (eq, ne, not, in).
jobTitle	String	Cargo para este contacto organizacional. $filter Suporta (eq, ne, not, ge, le, in, startsWithe eq para null valores).
email	String	O endereço SMTP para o contacto, por exemplo, "jeff@contoso.com". $filter Suporta (eq, ne, not, ge, le, in, startsWithe eq para null valores).
mailNickname	String	Email alias (parte do endereço de e-mail pré-pendente do símbolo @) para este contacto organizacional. $filter Suporta (eq, ne, not, ge, le, in, startsWithe eq para null valores).
onPremisesLastSyncDateTime	DateTimeOffset	Data e hora em que este contacto organizacional foi sincronizado pela última vez a partir do AD no 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 aprovisionamento de sincronização para este contacto organizacional. $filter Suporta (eq, not para categoria e propertyCausingError), /$count eq 0, /$count ne 0.
onPremisesSyncEnabled	Booliano	true se este objeto for sincronizado a partir de um diretório no local; falso se este objeto tiver sido originalmente sincronizado a partir de um diretório no local, mas já não estiver sincronizado e agora dominado no Exchange; nulo se este objeto nunca tiver sido sincronizado a partir de um diretório no local (predefinição). $filter Suporta (eq, ne, not, ine eq para null valores).
telefones	Coleção phone	Lista de telefones para este contacto organizacional. Os tipos de telefone podem ser móveis, empresariais e empresariaisFax. Apenas um de cada tipo pode estar presente na coleção. Suporta $filter (eq, ne, not, in).
proxyAddresses	String collection	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. Suporta $filter (eq, not, ge, le, startsWith, /$count eq 0, /$count ne 0).
serviceProvisioningErrors	serviceProvisioningError collection	Erros publicados por um serviço federado que descreve um erro não transitório específico do serviço relativo às propriedades ou ligação de um objeto orgContact. $filter Suporta (eq, not, para isResolved e serviceInstance).
surname	Cadeia de caracteres	Apelido deste contacto organizacional. $filter Suporta (eq, , nenot, ge, le, in, startsWithe eq para null valores)

Relações

Relação	Tipo	Descrição
directReports	Coleção directoryObject	Os relatórios diretos do contacto. (Os utilizadores e contactos que têm a respetiva propriedade de gestor definida para este contacto.) Só de leitura. Anulável. Suporta o $expand.
manager	directoryObject	O utilizador ou contacto que é o gestor deste contacto. Somente leitura. $expand Suporta e $filter (eq) por ID.
memberOf	Coleção directoryObject	Grupos de que este contacto é membro. Somente leitura. Anulável. Suporta o $expand.
transitiveReports	Coleção directoryObject	Os relatórios transitivos de um contacto. Somente leitura.

Representação JSON

A representação JSON seguinte mostra o tipo de 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"],
  "serviceProvisioningErrors": [{"@odata.type": "microsoft.graph.serviceProvisioningXmlError"}],
  "surname": "string"
}