Tipo de recurso contact
Espacio de nombres: microsoft.graph
Un contacto es un elemento de Outlook donde puede organizar y guardar información sobre las personas y organizaciones con las que se comunica. Los contactos se contienen en carpetas de contactos.
Este recurso admite:
- que agregue sus propios datos a las propiedades personalizadas como extensiones.
- que se suscriba a notificaciones de cambios.
- El uso de una consulta delta para realizar un seguimiento de adiciones, eliminaciones y actualizaciones incrementales al proporcionar una función delta.
Métodos
Método | Tipo de valor devuelto | Descripción |
---|---|---|
Obtener contacto | contact | Lea las propiedades y las relaciones del objeto de contacto. |
Crear contact | contact | Agregue un contacto a la carpeta de contactos raíz o al extremo de contactos de otra carpeta de contactos. |
Actualizar contacto | contact | Actualice el objeto de contacto. |
Eliminar contacto | Ninguno | Elimine el objeto contact. |
Obtener delta de contacto | Colección contact | Obtiene un conjunto de contactos que se hayan agregado, eliminado o actualizado en una carpeta determinada. |
Extensiones abiertas | ||
Crear extensión abierta | openTypeExtension | Crea una extensión abierta y agrega propiedades personalizadas en una instancia nueva o existente de un recurso. |
Obtener extensión abierta | Colección openTypeExtension | Obtiene un objeto u objetos de extensión abierta identificados por nombre o por nombre completo. |
Propiedades extendidas | ||
Crear una propiedad de valor único | contact | Cree una o varias propiedades extendidas de valor único en un contacto nuevo o existente. |
Obtener una propiedad de valor único | contact | Obtenga contactos que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter . |
Creación de una propiedad de varios valores | contact | Cree una o varias propiedades extendidas de varios valores en un contacto nuevo o existente. |
Obtención de la propiedad multivalor | contact | Obtenga un contacto que contiene una propiedad extendida de varios valores mediante el uso de $expand . |
Propiedades
Propiedad | Tipo | Descripción |
---|---|---|
assistantName | String | El nombre del ayudante del contacto. |
birthday | DateTimeOffset | El cumpleaños del contacto. 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 . |
businessAddress | PhysicalAddress | La dirección del trabajo del contacto. |
businessHomePage | String | La página principal de la empresa del contacto. |
businessPhones | Colección String | Los números de teléfono del trabajo del contacto. |
categories | Colección String | Las categorías asociadas con el contacto. |
changeKey | String | Identifica la versión del contacto. Cada vez que cambia el contacto, cambia también ChangeKey. Permite que Exchange aplique los cambios a la versión correcta del objeto. |
children | Colección String | Los nombres de los hijos del contacto. |
CompanyName | String | El nombre de la empresa del contacto. |
createdDateTime | DateTimeOffset | La hora en que se ha creado el contacto. 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 . |
department | String | El departamento del contacto. |
displayName | String | El nombre para mostrar del contacto. Puede especificar el nombre para mostrar en una operación de crear o actualizar. Tenga en cuenta que las actualizaciones posteriores a otras propiedades pueden hacer que un valor generado automáticamente sobrescriba el valor displayName que haya especificado. Para conservar un valor ya existente, debe incluirlo siempre como displayName en una operación de actualización. |
emailAddresses | Colección EmailAddress | Las direcciones de correo electrónico del contacto. |
fileAs | String | El nombre con el que se ha archivado el contacto. |
generation | String | Sufijo del contacto. |
givenName | String | El nombre del contacto. |
homeAddress | PhysicalAddress | La dirección particular del contacto. |
homePhones | Colección String | Los números de teléfono particular del contacto. |
id | String | El identificador único del contacto.
De forma predeterminada, este valor cambia cuando el elemento se mueve de un contenedor (como una carpeta o un calendario) a otro. Para cambiar este comportamiento, use el encabezado Prefer: IdType="ImmutableId" . Vea Obtener identificadores inmutables para recursos de Outlook para obtener más información. Solo lectura. |
imAddresses | Colección String | Las direcciones de mensajería instantánea (MI) del contacto. |
initials | String | Las iniciales del contacto. |
jobTitle | String | El puesto del contacto. |
lastModifiedDateTime | DateTimeOffset | La hora en que se ha modificado el contacto. 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 . |
manager | String | El nombre del administrador del contacto. |
middleName | String | El segundo nombre del contacto. |
mobilePhone | String | El número de teléfono móvil del contacto. |
nickName | String | El sobrenombre del contacto. |
officeLocation | String | La ubicación de la oficina del contacto. |
otherAddress | PhysicalAddress | Otras direcciones del contacto. |
parentFolderId | String | El identificador de la carpeta principal del contacto. |
personalNotes | String | Las notas del usuario sobre el contacto. |
profession | String | La profesión del contacto. |
spouseName | String | El nombre del cónyuge del contacto. |
surname | String | Los apellidos del contacto. |
title | String | El título del contacto. |
yomiCompanyName | String | El nombre fonético japonés de la empresa del contacto. |
yomiGivenName | String | El nombre (nombre de pila) fonético japonés del contacto. |
yomiSurname | String | Apellido fonético japonés (apellido) del contacto. |
Relaciones
Relación | Tipo | Descripción |
---|---|---|
extensions | Colección Extension | Colección de extensiones abiertas definidas para el contacto. Solo lectura. Admite un valor NULL. |
multiValueExtendedProperties | Colección multiValueLegacyExtendedProperty | La colección de propiedades extendidas de varios valores definidas para el contacto. Solo lectura. Admite un valor NULL. |
photo | profilePhoto | Imagen de contacto opcional. Puede obtener o establecer una foto para un contacto. |
singleValueExtendedProperties | Colección singleValueLegacyExtendedProperty | La colección de propiedades extendidas de valor único definidas para el contacto. Solo lectura. Admite valores NULL. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"assistantName": "string",
"birthday": "String (timestamp)",
"businessAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
"businessHomePage": "string",
"businessPhones": ["string"],
"categories": ["string"],
"changeKey": "string",
"children": ["string"],
"companyName": "string",
"createdDateTime": "String (timestamp)",
"department": "string",
"displayName": "string",
"emailAddresses": [{"@odata.type": "microsoft.graph.emailAddress"}],
"fileAs": "string",
"generation": "string",
"givenName": "string",
"homeAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
"homePhones": ["string"],
"id": "string (identifier)",
"imAddresses": ["string"],
"initials": "string",
"jobTitle": "string",
"lastModifiedDateTime": "String (timestamp)",
"manager": "string",
"middleName": "string",
"mobilePhone": "string",
"nickName": "string",
"officeLocation": "string",
"otherAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
"parentFolderId": "string",
"personalNotes": "string",
"photo": { "@odata.type": "microsoft.graph.profilePhoto" },
"profession": "string",
"spouseName": "string",
"surname": "string",
"title": "string",
"yomiCompanyName": "string",
"yomiGivenName": "string",
"yomiSurname": "string"
}
Contenido relacionado
- Usar la consulta delta para realizar el seguimiento de los cambios en datos de Microsoft Graph
- Obtener los cambios incrementales en los mensajes de una carpeta
- Agregar datos personalizados a los recursos mediante extensiones
- Agregar datos personalizados a los usuarios mediante extensiones abiertas
- Agregar datos personalizados a los grupos mediante extensiones de esquema