Compartilhar via


orgContact resource type

Namespace: microsoft.graph

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 Listar propriedades de contactos organizacionais.
Get orgContact Ler propriedades e relações de um contacto organizacional.
Hierarquia organizacional
Obter gerenciador directoryObject Obtenha o gestor do contacto organizacional.
Listar subordinados diretos Coleção directoryObject Listar os relatórios diretos do contacto organizacional.
Listar associações Coleção directoryObject Liste os grupos de que um contacto organizacional é membro.
Listar associações transitivas 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 existência de associação a grupos.
Obter grupos de membros Coleção de cadeias de caracteres Devolver todos os grupos dos quais o contacto organizacional especificado é membro.
Obter objetos de membros String collection Devolve uma lista de directoryObjects de que o contacto 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, 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).
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 de contacto organizacional .

$filter Suporta (eq, not, para isResolved e serviceInstance).
onPremisesLastSyncDateTime DateTimeOffset Data e hora em que este contacto organizacional foi sincronizado pela última vez a partir do AD no local. Estas informações de data e hora utilizam o formato ISO 8601 e estão sempre na hora 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; false 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; null 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.
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 Apelido deste contacto organizacional. $filter Suporta (eq, ne, not, 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.
transitiveMemberOf Coleção directoryObject Grupos dos quais este contacto é membro, incluindo grupos nos quais o contacto está aninhado. Somente leitura. Anulável.

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