Compartir vía

Tipo de recurso contact

  • Artículo

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