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 , , 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). |
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 (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; null 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. |
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 , , not ne , , le ge , 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 . |
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"
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários