tipo de recurso contactcontact resource type

Importante

Las API de /beta la versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported.

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.A contact is an item in Outlook where you can organize and save information about the people and organizations you communicate with. Contacts are contained in contact folders.

Este recurso admite:This resource supports:

Representación JSONJSON representation

Aquí tiene una representación JSON del recursoHere is a JSON representation of the resource

{
  "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"
}

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
assistantNameassistantName StringString El nombre del ayudante del contacto.The name of the contact's assistant.
birthdaybirthday DateTimeOffsetDateTimeOffset 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, medianoche UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'The contact's birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
categoríascategories Colección stringString collection Las categorías asociadas con el contacto.The categories associated with the contact. Cada categoría se corresponde con la propiedad displayName de un elemento outlookCategory definido para el usuario.Each category corresponds to the displayName property of an outlookCategory defined for the user.
changeKeychangeKey StringString 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.Identifies the version of the contact. Every time the contact is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
childrenchildren Colección StringString collection Los nombres de los hijos del contacto.The names of the contact's children.
companyNamecompanyName StringString El nombre de la empresa del contacto.The name of the contact's company.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 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, medianoche UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'The time the contact was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
departamentodepartment StringString El departamento del contacto.The contact's department.
displayNamedisplayName CadenaString El nombre para mostrar del contacto.The contact's display name. Puede especificar el nombre para mostrar en una operación de crear o actualizar.You can specify the display name in a create or update operation. 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.Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. Para conservar un valor ya existente, debe incluirlo siempre como displayName en una operación de actualización.To preserve a pre-existing value, always include it as displayName in an update operation.
emailAddressesemailAddresses colección typedEmailAddresstypedEmailAddress collection Las direcciones de correo electrónico del contacto.The contact's email addresses.
fileAsfileAs StringString El nombre con el que se ha archivado el contacto.The name the contact is filed under.
flagflag followupFlagfollowupFlag El valor de marca que indica el estado, la fecha de inicio, la fecha de vencimiento o la fecha de finalización del contacto.The flag value that indicates the status, start date, due date, or completion date for the contact.
gendergender StringString El sexo del contacto.The contact's gender.
generationgeneration StringString La generación del contacto.The contact's generation.
givenNamegivenName StringString El nombre del contacto.The contact's given name.
idid StringString Identificador único del contacto.Unique identifier for the contact. De forma predeterminada, este valor cambia cuando el elemento se mueve de un contenedor (como una carpeta o calendario) a otro.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Para cambiar este comportamiento, use el Prefer: IdType="ImmutableId" encabezado.To change this behavior, use the Prefer: IdType="ImmutableId" header. Consulte obtener identificadores inmutables para recursos de Outlook para obtener más información.See Get immutable identifiers for Outlook resources for more information.De sólo lectura.De forma predeterminada, este valor cambia cuando el elemento se mueve de un contenedor (como una carpeta o calendario) a otro.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Para cambiar este comportamiento, use el Prefer: IdType="ImmutableId" encabezado.To change this behavior, use the Prefer: IdType="ImmutableId" header. Consulte obtener identificadores inmutables para recursos de Outlook para obtener más información.See Get immutable identifiers for Outlook resources for more information. Read-only.
imAddressesimAddresses Colección StringString collection Las direcciones de mensajería instantánea (MI) del contacto.The contact's instant messaging (IM) addresses.
initialsinitials StringString Las iniciales del contacto.The contact's initials.
jobTitlejobTitle StringString El puesto del contacto.The contact’s job title.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset 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, medianoche UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'The time the contact was modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
managermanager StringString El nombre del administrador del contacto.The name of the contact's manager.
middleNamemiddleName StringString El segundo nombre del contacto.The contact's middle name.
nickNamenickName StringString El sobrenombre del contacto.The contact's nickname.
officeLocationofficeLocation StringString La ubicación de la oficina del contacto.The location of the contact's office.
parentFolderIdparentFolderId CadenaString El identificador de la carpeta principal del contacto.The ID of the contact's parent folder.
personalNotespersonalNotes StringString Las notas del usuario sobre el contacto.The user's notes about the contact.
phonesphones Colección phonephone collection Números de teléfono asociados con el contacto, por ejemplo, el teléfono particular, el teléfono móvil y el teléfono del trabajo.Phone numbers associated with the contact, for example, home phone, mobile phone, and business phone.
postalAddressespostalAddresses colección physicalAddressphysicalAddress collection Direcciones asociadas al contacto, por ejemplo, dirección particular y dirección de la empresa.Addresses associated with the contact, for example, home address and business address.
professionprofession StringString La profesión del contacto.The contact's profession.
spouseNamespouseName StringString El nombre del cónyuge del contacto.The name of the contact's spouse/partner.
surnamesurname StringString Los apellidos del contacto.The contact's surname.
titletitle CadenaString El título del contacto.The contact's title.
websiteswebsites Colección websitewebsite collection Sitios web asociados con el contacto.Web sites associated with the contact.
weddingAnniversaryweddingAnniversary FechaDate Aniversario de boda del contacto.The contact's wedding anniversary.
yomiCompanyNameyomiCompanyName StringString El nombre fonético japonés de la empresa del contacto.The phonetic Japanese company name of the contact.
yomiGivenNameyomiGivenName StringString El nombre (nombre de pila) fonético japonés del contacto.The phonetic Japanese given name (first name) of the contact.
yomiSurnameyomiSurname StringString El apellido fonético japonés del contacto.The phonetic Japanese surname (last name) of the contact.

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
extensionsextensions Colección Extensionextension collection La colección de extensiones abiertas definidas para el contacto.The collection of open extensions defined for the contact. Admite un valor NULL.Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties Colección multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection La colección de propiedades extendidas de varios valores definidas para el contacto. Solo lectura. Admite valores NULL.The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
Fotophoto photophoto Imagen de contacto opcional. Puede obtener o establecer una foto para un contacto.Optional contact picture. You can get or set a photo for a contact.
singleValueExtendedPropertiessingleValueExtendedProperties Colección singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection La colección de propiedades extendidas de valor único definidas para el contacto. Solo lectura. Admite valores NULL.The collection of single-value extended properties defined for the contact. Read-only. Nullable.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Obtener contactoGet contact contactocontact Lea las propiedades y las relaciones del objeto de contacto.Read properties and relationships of contact object.
CrearCreate contactocontact Agregue un contacto a la carpeta de contactos raíz o al extremo de contactos de otra carpeta de contactos.Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.
ActualizarUpdate contactocontact Actualice el objeto de contacto.Update contact object.
EliminarDelete NingunoNone Elimine el objeto contact.Delete contact object.
deltadelta Colección contactcontact collection Obtiene un conjunto de contactos que se hayan agregado, eliminado o actualizado en una carpeta determinada.Get a set of contacts that have been added, deleted, or updated in a specified folder.
Extensiones abiertasOpen extensions
Crear extensión abiertaCreate open extension openTypeExtensionopenTypeExtension Crea una extensión abierta y agrega propiedades personalizadas en una instancia nueva o un recurso existente.Create an open extension and add custom properties to a new or existing resource.
Obtener extensión abiertaGet open extension Colección openTypeExtensionopenTypeExtension collection Obtiene una extensión abierta identificada por el nombre de extensión.Get an open extension identified by the extension name.
Extensiones de esquemaSchema extensions
Agregar valores de extensión de esquemaAdd schema extension values Cree una definición de extensión de esquema y, después, úsela para agregar datos escritos personalizados a un recurso.Create a schema extension definition and then use it to add custom typed data to a resource.
Propiedades extendidasExtended properties
Crear propiedad extendida de valor únicoCreate single-value extended property contactocontact Cree una o varias propiedades extendidas de valor único en un contacto nuevo o existente.Create one or more single-value extended properties in a new or existing contact.
Obtener contacto con propiedad extendida de valor únicoGet contact with single-value extended property contactocontact Obtenga contactos que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter.Get contacts that contain a single-value extended property by using $expand or $filter.
Crear propiedad extendida de varios valoresCreate multi-value extended property contactcontact Cree una o varias propiedades extendidas de varios valores en un contacto nuevo o existente.Create one or more multi-value extended properties in a new or existing contact.
Obtener contacto con propiedad extendida de varios valoresGet contact with multi-value extended property contactcontact Obtenga un contacto que contiene una propiedad extendida de varios valores mediante el uso de $expand.Get a contact that contains a multi-value extended property by using $expand.

Vea tambiénSee also