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 Leia 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 Liste os grupos dos quais um contato organizacional é membro.
Lista transitiveMemberOf Coleção directoryObject Liste os grupos dos quais um contato organizacional é membro, incluindo grupos nos quais o contato organizacional está aninhado.
checkMemberGroups String collection Verifique se há associação de grupo.
getMemberGroups String collection Retorne todos os grupos dos quais o contato organizacional especificado é membro.
getMemberObjects String collection Retorna uma lista de diretórioSobjetos dos quais 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 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).
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 de contato organizacional .

$filter Dá suporte (eq, not, para isResolved e serviceInstance).
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 em tempo 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; null 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.
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).
surname Cadeia de caracteres Sobrenome para esse contato organizacional. $filter Dá suporte (eq, , notne, , lege, 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.
transitiveMemberOf Coleção directoryObject Grupos dos quais esse contato é membro, incluindo grupos nos quais o contato está aninhado. Somente leitura. Anulável.

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