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 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	Leia 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	Obtenha uma coleção de objetos memberOf.
checkMemberGroups	String collection	Verifique se há associação de grupo.
getMemberGroups	String collection	Retorne todos os grupos dos quais 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	String collection	Obtenha a lista de grupos, unidades administrativas e funções de diretório das quais 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 Recursos avançados de consulta em objetos de diretório.

Propriedade	Tipo	Descrição
Endereços	coleção physicalOfficeAddress	Endereços postais para esse contato organizacional. Por enquanto, um contato só pode ter um endereço físico.
CompanyName	String	Nome da empresa à qual esse contato organizacional pertence. $filter Dá suporte (eq, , notne, , lege, in, , startsWithe eq para null valores).
department	String	O nome do departamento no qual o contato funciona. $filter Dá suporte (eq, , notne, , lege, in, , startsWithe eq para null valores).
displayName	Cadeia de caracteres	Nome de exibição para esse contato organizacional. $filter Dá suporte (eq, , notne, ge, le, in, , startsWithe eq para null valores), $searche $orderby.
givenName	Cadeia de caracteres	Primeiro nome para esse contato organizacional. $filter Dá suporte (eq, , notne, , lege, in, , startsWithe eq para null valores).
id	Cadeia de caracteres	Identificador exclusivo para esse contato organizacional. Suporta $filter (eq, ne, not, in).
jobTitle	String	Título de trabalho para esse contato organizacional. $filter Dá suporte (eq, , notne, , lege, in, , startsWithe eq para null valores).
email	String	O endereço SMTP para o contato, por exemplo, "jeff@contoso.com". $filter Dá suporte (eq, , notne, , lege, in, , startsWithe eq para null valores).
mailNickname	String	Email alias (parte do endereço de email pré-pendente do símbolo @) para esse contato organizacional. $filter Dá suporte (eq, , notne, , lege, in, , startsWithe eq para 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 esse contato organizacional. $filter Dá suporte (eqpara notcategoria e propriedadeCausingError), /$count eq 0, . /$count ne 0
onPremisesSyncEnabled	Booliano	true se esse objeto for sincronizado de um diretório local; false se esse objeto foi originalmente sincronizado de um diretório local, mas não estiver mais sincronizado e agora dominado no Exchange; nulo se esse objeto nunca tiver sido sincronizado de um diretório local (padrão). $filter Dá suporte (eq, , notne, ine eq para null valores).
telefones	Coleção phone	Lista de telefones para esse contato organizacional. Os tipos de telefone podem ser móveis, empresariais e businessFax. 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	coleção serviceProvisioningError	Erros publicados por um serviço federado descrevendo um erro não transitório e específico do serviço em relação às propriedades ou link de um objeto orgContact . $filter Dá suporte (eq, not, para isResolved e serviceInstance).
surname	Cadeia de caracteres	Sobrenome para esse contato organizacional. $filter Dá suporte (eq, , notne, ge, le, in, startsWithe eq para 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 a propriedade do gerente definida como esse contato.) Somente leitura. Anulável. Suporta o $expand.
manager	directoryObject	O usuário ou contato que é o gerente desse contato. Somente leitura. $expand Dá suporte e $filter (eq) por id.
memberOf	Coleção directoryObject	Grupos dos quais esse contato é membro. Somente leitura. Anulável. Suporta o $expand.
transitiveReports	Coleção directoryObject	Os relatórios transitivos para um contato. Somente leitura.

Representação JSON

A representação JSON a seguir 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"
}