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 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 | Listar propriedades de contactos organizacionais. |
| Get | orgContact | Ler propriedades e relações de um contacto organizacional. |
| 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 membros transitivos 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. |
| 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. |
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). |
| 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). |
| 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 de que este contacto é membro. Somente leitura. Anulável. Suporta o $expand. |
| transitiveMemberOf | Coleção directoryObject | Grupos de que 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"
}