Partilhar via

orgContact resource type

  • Artigo

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
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 String collection 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. O comprimento máximo é de 256 caracteres. $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"
}