Compartir a través de


Tipo de recurso contact

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta 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 Versión.

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
Get contact Lea las propiedades y las relaciones del objeto de contacto.
Crear contact Agregue un contacto a la carpeta de contactos raíz o al extremo de contactos de otra carpeta de contactos.
Actualizar contact Actualice el objeto de contacto.
Eliminar Ninguno Elimine el objeto contact.
Eliminar permanentemente Ninguno Eliminar permanentemente un contacto y colocarlo en la carpeta Purgas de la carpeta Elementos recuperables del buzón del usuario.
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 un recurso existente.
Obtener extensión abierta Colección openTypeExtension Obtiene una extensión abierta identificada por el nombre de extensión.
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.
categories Colección String Las categorías asociadas con el contacto. Cada categoría se corresponde con la propiedad displayName de un elemento outlookCategory definido para el usuario.
changeKey String Identifica la versión del contacto. Cada vez que se cambia el contacto, changeKey cambia también, lo que permite a Exchange aplicar 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. Las actualizaciones posteriores de otras propiedades pueden hacer que un valor generado automáticamente sobrescriba el valor displayName especificado. Para conservar un valor ya existente, debe incluirlo siempre como displayName en una operación de actualización.
emailAddresses colección typedEmailAddress Las direcciones de correo electrónico del contacto.
fileAs String El nombre con el que se ha archivado el contacto.
flag followupFlag Valor de marca que indica el estado, la fecha de inicio, la fecha de vencimiento o la fecha de finalización del contacto.
gender Cadena El sexo del contacto.
generation String Sufijo del contacto.
givenName String El nombre del contacto.
id Cadena 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.
nickName String El sobrenombre del contacto.
officeLocation String La ubicación de la oficina del contacto.
parentFolderId String El identificador de la carpeta principal del contacto.
personalNotes String Las notas del usuario sobre el contacto.
phones Colección phone Números de teléfono asociados con el contacto, por ejemplo, teléfono doméstico, teléfono móvil y teléfono empresarial.
postalAddresses colección physicalAddress Direcciones asociadas al contacto, por ejemplo, la dirección principal y la dirección de negocio.
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.
websites Colección website Sitios web asociados al contacto.
weddingAnniversary Fecha El aniversario de la boda 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. Admite un valor NULL.
multiValueExtendedProperties Colección multiValueLegacyExtendedProperty La colección de propiedades extendidas de varios valores definidas para el contacto. Solo lectura. Admite valores NULL.
photo photo 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)",
  "categories": ["string"],
  "changeKey": "string",
  "children": ["string"],
  "companyName": "string",
  "createdDateTime": "String (timestamp)",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.typedEmailAddress"}],
  "fileAs": "string",
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "gender": "string",
  "generation": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "initials": "string",
  "jobTitle": "string",
  "lastModifiedDateTime": "String (timestamp)",
  "manager": "string",
  "middleName": "string",
  "nickName": "string",
  "officeLocation": "string",
  "parentFolderId": "string",
  "personalNotes": "string",
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.physicalAddress"}],
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "websites": [{"@odata.type": "microsoft.graph.website"}],
  "weddingAnniversary": "date",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"
}