tipo de recurso contactcontact resource type

Espacio de nombres: microsoft.graphNamespace: 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.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:

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Obtener contactoGet contact contactcontact Lea las propiedades y las relaciones del objeto de contacto.Read properties and relationships of contact object.
CrearCreate contactcontact 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 contactcontact 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 existente de un recurso.Create an open extension and add custom properties in a new or existing instance of a resource.
Obtener extensión abiertaGet open extension Colección openTypeExtensionopenTypeExtension collection Obtenga un objeto u objetos de extensión abierta identificados por nombre o por nombre completo.Get an open extension object or objects identified by name or fully qualified 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 contactcontact 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 contactcontact 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.

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'
businessAddressbusinessAddress PhysicalAddressPhysicalAddress La dirección del trabajo del contacto.The contact's business address.
businessHomePagebusinessHomePage StringString La página principal de la empresa del contacto.The business home page of the contact.
businessPhonesbusinessPhones Colección StringString collection Los números de teléfono del trabajo del contacto.The contact's business phone numbers.
categoriescategories Colección StringString collection Las categorías asociadas con el contacto.The categories associated with the contact.
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 StringString 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 EmailAddressEmailAddress 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.
generationgeneration StringString La generación del contacto.The contact's generation.
givenNamegivenName StringString El nombre del contacto.The contact's given name.
homeAddresshomeAddress PhysicalAddressPhysicalAddress La dirección particular del contacto.The contact's home address.
homePhoneshomePhones Colección StringString collection Los números de teléfono particular del contacto.The contact's home phone numbers.
idid StringString El identificador único del contacto. Solo lectura.The contact's unique identifier. 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.
mobilePhonemobilePhone StringString El número de teléfono móvil del contacto.The contact's mobile phone number.
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.
otherAddressotherAddress PhysicalAddressPhysicalAddress Otras direcciones del contacto.Other addresses for the contact.
parentFolderIdparentFolderId StringString 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.
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 StringString El título del contacto.The contact's title.
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. Solo lectura. Admite valores NULL.The collection of open extensions defined for the contact. Read-only. 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 profilePhotoprofilePhoto 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.

Representación JSONJSON representation

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

{
  "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",
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string",

  "photo": { "@odata.type": "microsoft.graph.profilePhoto" }
}

Consulte tambiénSee also