Tipo de recurso orgContact

Espacio de nombres: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de versiones .

Representa un contacto de la organización. Los contactos de la organización los administran los administradores de una organización y son diferentes de los contactos personales. Además, los contactos de la organización se sincronizan desde directorios locales o desde Exchange Online y son de solo lectura en Microsoft Graph.

Se hereda de directoryObject.

Este recurso es compatible con el uso de una consulta delta para realizar un seguimiento de las adiciones incrementales, las eliminaciones y las actualizaciones proporcionando una función delta. Este recurso es de tipo abierto y permite que pasen otras propiedades.

Methods

Método	Tipo de valor devuelto	Descripción
Contactos de la organización
Enumerar contactos de la organización	OrgContact (colección)	Enumera las propiedades de los contactos de la organización.
Obtener contacto de la organización	orgContact	Lee las propiedades y las relaciones del objeto orgContact.
Jerarquía organizativa
Obtener administrador	directoryObject	Obtenga el administrador del contacto.
Obtener transitiveReports	Entero	Obtenga el recuento de informes transitivos para un contacto de organización de la propiedad de navegación transitiveReports.
Enumerar directReports	Colección directoryObject	Enumere los informes directos del contacto.
Enumerar memberOf	Colección directoryObject	Obtenga una colección de objetos memberOf.
checkMemberGroups	Colección string	Compruebe si hay pertenencia a grupos.
getMemberGroups	Colección de cadenas	Devuelve todos los grupos de los que es miembro el contacto especificado.
checkMemberObjects	Colección de cadenas	Compruebe si hay pertenencia a grupos, unidades administrativas y roles de directorio.
getMemberObjects	Colección de cadenas	Obtenga la lista de grupos, unidades administrativas y roles de directorio de los que es miembro el contacto.

Propiedades

Importante

El uso específico de $filter y el parámetro de consulta $search solo se admite cuando se usa el encabezado ConsistencyLevel establecido en eventual y $count. Para obtener más información, vea funciones de consulta avanzadas en Azure AD objetos de directorio.

Propiedad	Tipo	Descripción
Direcciones	colección physicalOfficeAddress	Direcciones postales de este contacto organizativo. Por ahora, un contacto solo puede tener una dirección física.
CompanyName	String	Nombre de la empresa a la que pertenece este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
department	Cadena	Nombre del departamento en el que funciona el contacto. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
displayName	Cadena	Nombre para mostrar de este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null), $search y $orderBy.
givenName	Cadena	Nombre de este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
id	Cadena	Identificador único de este contacto organizativo. Admite $filter (eq, ne, not, in).
jobTitle	Cadena	Puesto de trabajo para este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
mail	Cadena	La dirección SMTP del contacto, por ejemplo, "jeff@contoso.onmicrosoft.com". Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
mailNickname	Cadena	Alias de correo electrónico (parte de la dirección de correo electrónico pendiente previamente del símbolo @) para este contacto de la organización. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null).
onPremisesLastSyncDateTime	DateTimeOffset	Fecha y hora en que este contacto organizativo se sincronizó por última vez desde AD local. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Admite $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors	Colección OnPremisesProvisioningError	Lista de los errores de aprovisionamiento de sincronización de este contacto de la organización. Admite $filter (eq, not).
onPremisesSyncEnabled	Booleano	true si este objeto se sincroniza desde un directorio local; false si este objeto se sincronizó originalmente desde un directorio local, pero ya no está sincronizado y ahora se ha masterizado en Exchange; null si este objeto nunca se ha sincronizado desde un directorio local (valor predeterminado). Admite $filter (eq, ne, not, in y eq en valores null).
phones	Colección phone	Lista de teléfonos para este contacto de la organización. Teléfono tipos pueden ser móviles, empresariales y businessFax. Solo uno de cada tipo puede estar presente en la colección. Admite $filter (eq, ne, not, in).
proxyAddresses	Colección string	Por ejemplo: "SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com". El operador any es necesario para las expresiones de filtro en las propiedades de varios valores. Admite $filter (eq, not, ge, le, startsWith, y contar colecciones vacías).
surname	Cadena	Apellidos de este contacto organizativo. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null)

Relaciones

Relación	Tipo	Descripción
directReports	Colección directoryObject	Informes directos del contacto. (Los usuarios y contactos que tienen su propiedad de administrador establecida en este contacto). Solo lectura. Admite un valor NULL. Admite $expand.
manager	directoryObject	El usuario o contacto que es el administrador de este contacto. Solo lectura. Admite $expand.
memberOf	Colección directoryObject	Grupos de los que es miembro este contacto. Solo lectura. Admite un valor NULL. Admite $expand.
transitiveReports	Colección directoryObject	Los informes transitivos de un contacto. Solo lectura.

Representación JSON

Aquí tiene una representación JSON del 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"],
  "surname": "string"
}