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 do 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
List	orgContact collection	Listar propriedades de contactos organizacionais.
Get	orgContact	Ler propriedades e relações do objeto orgContact.
Obter delta	orgContact collection	Obtenha contactos organizacionais recentemente criados, atualizados ou eliminados sem ter de efetuar uma leitura completa de toda a coleção.
Obter delta para objeto de diretório	coleção direcyoryObject	Obtenha contactos organizacionais recentemente criados, atualizados ou eliminados através da coleção de objetos de diretório sem ter de efetuar uma leitura completa de toda a coleção.
Listar membro de	String collection	Obtenha a lista de grupos e unidades administrativas de que o contacto é membro. A verificação é transitiva.
Listar membro transitivo de	Coleção directoryObject	Liste os grupos dos quais um contacto organizacional é membro, incluindo grupos nos quais o contacto organizacional está aninhado.
Verificar grupos de membros	String collection	Verifique a associação de um contacto organizacional numa lista de grupos. A verificação é transitiva.
Obter grupos de membros	String collection	Devolver todos os grupos dos quais o contacto organizacional é membro. A verificação é transitiva.
Verificar objetos de membro	Coleção String	Verifique a associação de um contacto organizacional numa lista de grupos, função de diretório ou objetos de unidade administrativa.
Obter objetos de membros	String collection	Devolver todos os grupos, unidades administrativas e funções de diretório dos quais o contacto organizacional é membro. A verificação é transitiva.
Repetir o aprovisionamento do serviço	Nenhum	Repita o aprovisionamento do serviço orgContact.
Obter relatórios transitivos	Número inteiro	Obtenha a contagem de relatórios transitivos para um contacto da organização a partir da propriedade de navegação transitiveReports.
Hierarquia organizacional
Obter gerenciador	directoryObject	Obtenha o gestor do contacto.
Listar subordinados diretos	Coleção directoryObject	Listar os relatórios diretos do contacto.

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	Alias de e-mail (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	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. 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 dos quais 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"
}