orgContact tipo de recurso

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 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 orgColeção de contatos Listar propriedades de contatos organizacionais.
Get orgContact Leia as propriedades e as relações do objeto orgContact.
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 membro transitivo 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.
Obter relatórios transitivos Número inteiro Obtenha a contagem de relatórios transitivos para um contato da organização na propriedade de navegação transitiveReports.
Comportamento de sincronização local (fonte de autoridade)
Get onPremisesSyncBehavior Verifique se a fonte de autoridade (SOA) do objeto de contato é a nuvem ou o Active Directory local.
Atualizar onPremisesSyncBehavior Atualize a SOA (fonte de autoridade) do objeto de contato para a nuvem ou o Active Directory local.
Hierarquia organizacional
Obter gerenciador directoryObject Contate o gerente do contato.
Listar subordinados diretos Coleção directoryObject Liste os subordinados diretos do contato.

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).
onPremisesLastSyncDateTime DateTimeOffset Data e hora em que este 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 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 este objeto for sincronizado de um diretório local; falso se este objeto foi originalmente sincronizado de um diretório local, mas não está mais sincronizado e agora é dominado no Exchange; NULL se o 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. 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 (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 orgContact.
Suporta $filter (eq, not, para isResolved e serviceInstance).
surname Cadeia de caracteres Sobrenome para este contato organizacional. Dá suporte a $filter (eqvalores , ne, not, ge, le, startsWithin, e 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.
onPremisesSyncBehavior onPremisesSyncBehavior Indica o estado da sincronização de um orgContact entre a nuvem e o Active Directory local. Dá suporte $filter apenas a recursos avançados de consulta, por exemplo, $filter=onPremisesSyncBehavior/isCloudManaged eq true&$count=true.
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"
}
  • Last updated on