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 , , not ne , , le ge , in , , startsWith e eq para null valores). |
department | String | O nome do departamento no qual o contato funciona. $filter Dá suporte (eq , , not ne , , le ge , in , , startsWith e eq para null valores). |
displayName | Cadeia de caracteres | Nome de exibição para esse contato organizacional. $filter Dá suporte (eq , , not ne , ge , le , in , , startsWith e eq para null valores), $search e $orderby . |
givenName | Cadeia de caracteres | Primeiro nome para esse contato organizacional. $filter Dá suporte (eq , , not ne , , le ge , in , , startsWith e 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 , , not ne , , le ge , in , , startsWith e eq para null valores). |
String | O endereço SMTP para o contato, por exemplo, "jeff@contoso.com". $filter Dá suporte (eq , , not ne , , le ge , in , , startsWith e 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 , , not ne , , le ge , in , , startsWith e 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 (eq para not categoria 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 , , not ne , in e 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 , , not ne , ge , le , in , startsWith e 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"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de