orgContact tipo de recurso

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 do 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 propriedades adicionais além daquelas documentadas aqui.

Métodos

Método Tipo de retorno Descrição
Contatos organizacionais
List orgContact Listar propriedades de contatos organizacionais.
Get orgContact Ler propriedades e relações de um contato organizacional.
Obter delta orgColeção de contatos Obtenha contatos organizacionais recém-criados, atualizados ou excluídos sem precisar realizar uma leitura completa de toda a coleção.
Obter delta para objeto de diretório coleção direcyoryObject Obtenha contatos organizacionais recém-criados, atualizados ou excluídos por meio da coleção de objetos de diretório sem precisar executar uma leitura completa de toda a coleção.
Listar membro de String collection Recupere a lista de grupos e unidades administrativas dos quais o contato é membro. A verificação é transitiva.
Listar membros transitivos de Coleção directoryObject Listar os grupos dos quais um contato organizacional é membro, incluindo grupos nos quais o contato organizacional está aninhado.
Verificar grupos de membros String collection Verifique a associação de um contato organizacional em uma lista de grupos. A verificação é transitiva.
Obter grupos de membros String collection Retorne todos os grupos dos quais o contato organizacional é membro. A verificação é transitiva.
Verificar objetos de membro String collection Verificar a associação de um contato organizacional em uma lista de grupos, funções de diretório ou objetos de unidade administrativa.
Obter objetos de membros String collection Retorne todos os grupos, unidades administrativas e funções de diretório das quais o contato organizacional é membro. A verificação é transitiva.
Repetir o provisionamento do serviço Nenhum Tente novamente o provisionamento do serviço orgContact.
Hierarquia organizacional
Obter gerenciador directoryObject Contate o gerente do contato organizacional.
Listar subordinados diretos Coleção directoryObject Liste os subordinados diretos do contato 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, consulte Recursos avançados de consulta em objetos de diretório.

Propriedade Tipo Descrição
endereços Coleção physicalOfficeAddress Endereços postais para este contato organizacional. Por enquanto, um contato só pode ter um endereço físico.
CompanyName String Nome da empresa à qual este contato organizacional pertence. Dá suporte a $filter (eqvalores , ne, not, ge, startsWithleine eq fornull).
department String O nome do departamento no qual o contato trabalha. Dá suporte a $filter (eqvalores , ne, not, ge, startsWithleine eq fornull).
displayName Cadeia de caracteres Nome de exibição para este contato organizacional. O comprimento máximo é de 256 caracteres. Dá suporte $filter a (eq, ne, not, legein, , startsWith, , e eq para null valores), $search, e .$orderby
givenName Cadeia de caracteres Nome para este contato organizacional. Dá suporte a $filter (eqvalores , ne, not, ge, startsWithleine eq fornull).
id Cadeia de caracteres Identificador exclusivo para este contato organizacional. Suporta $filter (eq, ne, not, in).
jobTitle String Cargo para este contato organizacional. Dá suporte a $filter (eqvalores , ne, not, ge, startsWithleine eq fornull).
email String O endereço SMTP para o contato, por exemplo, "jeff@contoso.com". Dá suporte a $filter (eqvalores , ne, not, ge, startsWithleine eq fornull).
mailNickname String Alias de Email (parte do endereço de email anterior ao símbolo @) para este contato organizacional. Dá suporte a $filter (eqvalores , ne, not, ge, startsWithleine eq fornull).
serviceProvisioningErrors serviceProvisioningError (em inglês) Erros publicados por um serviço federado descrevendo um erro não transitório, específico do serviço em relação às propriedades ou ao link de um objeto de contato organizacional.

Suporta $filter (eq, not, para isResolved e serviceInstance).
onPremisesLastSyncDateTime DateTimeOffset Data e hora em que este 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 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 quaisquer erros de provisionamento de sincronização para este contato organizacional. Supports $filter (eq, not for category and propertyCausingError), /$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 está mais sincronizado e agora é dominado no Exchange; null Se esse objeto nunca tiver sido sincronizado de um diretório local (padrão).

Dá suporte a $filter (eq, ne, innot, e eq para null valores).
telefones Coleção phone Lista de telefones para este contato organizacional. Os tipos de telefone podem ser móvel, business 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 este contato organizacional. Dá suporte a $filter (eqvalores , ne, not, ge, startsWithleine eq fornull).

Relações

Relação Tipo Descrição
directReports Coleção directoryObject Os subordinados diretos do contato. (Os usuários e contatos que têm suas propriedades de gerente definidas para esse contato.) Somente leitura. Anulável. Suporta o $expand.
manager directoryObject O usuário ou contato que é o gerente desse contato. Somente leitura. Suporta $expand e $filter (eq) por id.
memberOf Coleção directoryObject Grupos dos quais este contato é membro. Somente leitura. Anulável. Suporta o $expand.
transitiveMemberOf Coleção directoryObject Grupos dos quais este 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"
}
  • Last updated on