Class Contact

Contacto

Obsoleto. En su lugar, usa el servicio avanzado de la API de People.

Un contacto contiene el nombre, la dirección y varios detalles de contacto de un contacto.

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
addAddress(label, address)	AddressField	Agrega una dirección al contacto con una etiqueta estándar o personalizada.
addCompany(company, title)	CompanyField	Agrega una empresa al contacto.
addCustomField(label, content)	CustomField	Agrega un campo personalizado al contacto con una etiqueta extendida o personalizada.
addDate(label, month, day, year)	DateField	Agrega una fecha al contacto con una etiqueta estándar o personalizada.
addEmail(label, address)	EmailField	Agrega una dirección de correo electrónico con una etiqueta estándar (casa, trabajo, etc.) o una etiqueta personalizada {@code // The code below retrieves a contact named "John Doe" and adds the email // address "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
addIM(label, address)	IMField	Agrega una dirección de MI al contacto con una etiqueta estándar o personalizada.
addPhone(label, number)	PhoneField	Agrega un número de teléfono al contacto con una etiqueta estándar o personalizada.
addToGroup(group)	Contact	Agrega este contacto al grupo de contactos determinado.
addUrl(label, url)	UrlField	Agrega una URL al contacto con una etiqueta estándar o personalizada.
deleteContact()	void	Borra este contacto.
getAddresses()	AddressField[]	Obtiene todas las direcciones de este contacto.
getAddresses(label)	AddressField[]	Obtiene todas las direcciones de este contacto que coincidan con un campo en particular.
getCompanies()	CompanyField[]	Obtiene todas las empresas de este contacto.
getContactGroups()	ContactGroup[]	Obtiene todos los grupos de contactos que contienen este contacto.
getCustomFields()	CustomField[]	Obtiene todos los campos personalizados de este contacto.
getCustomFields(label)	CustomField[]	Obtiene todos los campos personalizados de este contacto que coincidan con un campo en particular.
getDates()	DateField[]	Obtiene todas las fechas de este contacto.
getDates(label)	DateField[]	Obtiene todas las fechas de este contacto que coincidan con un campo en particular.
getEmailAddresses()	String[]	Obtiene una lista de las direcciones de correo electrónico disponibles para este contacto.
getEmails()	EmailField[]	Obtiene las direcciones de correo electrónico de este contacto.
getEmails(label)	EmailField[]	Obtiene las direcciones de correo electrónico de este contacto que coinciden con un campo en particular.
getFamilyName()	String	Obtiene el apellido del contacto como una cadena.
getFullName()	String	Obtiene el nombre completo (nombre y apellido) del contacto como una cadena.
getGivenName()	String	Obtiene el nombre de pila (nombre) del contacto como una cadena.
getHomeAddress()	String	Obtiene la dirección particular de este contacto o una cadena vacía si no existe ninguna.
getHomeFax()	String	Obtiene el número de fax particular de este contacto o una cadena vacía si no existe.
getHomePhone()	String	Obtiene el número de teléfono fijo de este contacto o una cadena vacía si no existe.
getIMs()	IMField[]	Obtiene todas las direcciones de MI de este contacto.
getIMs(label)	IMField[]	Obtiene todas las direcciones de MI de este contacto que coincidan con un campo en particular.
getId()	String	Devuelve el ID único de este contacto.
getInitials()	String	Obtiene las iniciales del contacto.
getLastUpdated()	Date	Obtiene la fecha en la que se actualizó este contacto por última vez.
getMaidenName()	String	Obtiene el apellido de soltera del contacto como una cadena.
getMiddleName()	String	Obtiene el segundo nombre del contacto como una cadena.
getMobilePhone()	String	Obtiene el número de teléfono celular de este contacto o una cadena vacía si no existe.
getNickname()	String	Obtiene el sobrenombre del contacto como una cadena.
getNotes()	String	Obtiene las notas asociadas con este contacto o una cadena vacía si no hay notas.
getPager()	String	Obtiene el número de teléfono del buscapersonas de este contacto o una cadena vacía si no existe.
getPhones()	PhoneField[]	Obtiene todos los números de teléfono de este contacto.
getPhones(label)	PhoneField[]	Obtiene todos los números de teléfono de este contacto que coincidan con un campo en particular.
getPrefix()	String	Obtiene el prefijo del nombre del contacto.
getPrimaryEmail()	String	Obtiene la dirección de correo electrónico principal del contacto como una cadena.
getShortName()	String	Obtiene el nombre corto del contacto como una cadena.
getSuffix()	String	Obtiene el sufijo del nombre del contacto.
getUrls()	UrlField[]	Obtiene todas las URLs de este contacto.
getUrls(label)	UrlField[]	Obtiene todas las URLs de este contacto que coincidan con un campo en particular.
getUserDefinedField(key)	String	Obtiene el valor definido por el usuario asociado con la clave determinada.
getUserDefinedFields()	Object	Obtiene todos los campos definidos por el usuario para este contacto y los muestra como las propiedades de un objeto de JavaScript.
getWorkAddress()	String	Obtiene la dirección de trabajo de este contacto o una cadena vacía si no existe.
getWorkFax()	String	Obtiene el número de fax de trabajo de este contacto o una cadena vacía si no existe.
getWorkPhone()	String	Obtiene el número de teléfono de trabajo de este contacto o una cadena vacía si no existe.
removeFromGroup(group)	Contact	Quita este contacto del grupo de contactos determinado.
setFamilyName(familyName)	Contact	Establece el apellido del contacto.
setFullName(fullName)	Contact	Establece el nombre completo (nombre y apellido) del contacto.
setGivenName(givenName)	Contact	Establece el nombre de pila (nombre) del contacto.
setHomeAddress(addr)	void	Establece la dirección particular de este contacto.
setHomeFax(phone)	void	Establece el número de fax particular de este contacto.
setHomePhone(phone)	void	Establece el número de teléfono particular de este contacto.
setInitials(initials)	Contact	Establece las iniciales del contacto.
setMaidenName(maidenName)	Contact	Establece el apellido de soltera del contacto.
setMiddleName(middleName)	Contact	Establece el segundo nombre del contacto.
setMobilePhone(phone)	void	Establece el número de teléfono celular de este contacto.
setNickname(nickname)	Contact	Establece el sobrenombre del contacto.
setNotes(notes)	Contact	Establece las notas asociadas con este contacto.
setPager(phone)	void	Establece el número de buscapersonas de este contacto.
setPrefix(prefix)	Contact	Establece el prefijo en el nombre del contacto.
setPrimaryEmail(primaryEmail)	void	Establece la dirección de correo electrónico principal de este contacto.
setShortName(shortName)	Contact	Establece el nombre corto del contacto.
setSuffix(suffix)	Contact	Establece el sufijo en el nombre del contacto.
setUserDefinedField(key, value)	void	Establece un solo campo definido por el usuario para este contacto, que se almacenará con una clave determinada.
setUserDefinedFields(o)	void	Establece los campos definidos por el usuario para este contacto con las propiedades del objeto determinado.
setWorkAddress(addr)	void	Establece la dirección de trabajo de este contacto.
setWorkFax(phone)	void	Establece el número de fax de trabajo de este contacto.
setWorkPhone(phone)	void	Establece el número de teléfono de trabajo de este contacto.

Métodos obsoletos

addAddress(label, address)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega una dirección al contacto con una etiqueta estándar o personalizada.

La etiqueta puede ser de ContactsApp.Field o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const address = contacts[0].addAddress(
    ContactsApp.Field.WORK_ADDRESS,
    '123 Main St, Some City, NY 10011',
);

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta de la dirección nueva, ya sea de ContactsApp.Field o de una cadena personalizada
address	String	la dirección nueva

Volver

AddressField: Es el campo recién creado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getAddresses()

---

addCompany(company, title)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega una empresa al contacto.

// The code below retrieves a contact named "John Doe" and adds the company
// "Google" and the job title "Product Manager".
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addCompany('Google', 'Product Manager');

Parámetros

Nombre	Tipo	Descripción
company	String	el nombre de la empresa que deseas agregar a este contacto
title	String	el cargo asociado a este contacto para esta empresa

Volver

CompanyField: Es el campo recién creado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getCompanies()

---

addCustomField(label, content)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega un campo personalizado al contacto con una etiqueta extendida o personalizada.

La etiqueta puede ser de ContactsApp.ExtendedField o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field
// named 'HOBBY'.
const contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta de la dirección nueva, ya sea de ContactsApp.ExtendedField o de una cadena personalizada
content	Object	el valor que se almacenará en el campo personalizado

Volver

CustomField: Es el campo recién creado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getCustomFields()

---

addDate(label, month, day, year)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega una fecha al contacto con una etiqueta estándar o personalizada.

La etiqueta puede ser de ContactsApp.Field o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].addDate(
    ContactsApp.Field.BIRTHDAY,
    ContactsApp.Month.APRIL,
    19,
    1950,
);

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta de la fecha nueva, ya sea de ContactsApp.Field o de una cadena personalizada
month	Month	el mes, de ContactApps.Month
day	Integer	el día
year	Integer	el año

Volver

DateField: Es la fecha de creación.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getDates()

---

addEmail(label, address)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega una dirección de correo electrónico con una etiqueta estándar (casa, trabajo, etc.) o una etiqueta personalizada

// The code below retrieves a contact named "John Doe" and adds the email
// address "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emailField = contacts[0].addEmail(
    ContactsApp.Field.HOME_EMAIL,
    '[e-mail]',
);

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta del correo electrónico nuevo, ya sea de ContactsApp.Field o de una cadena personalizada
address	String	la nueva dirección de correo electrónico

Volver

EmailField: Es el campo recién agregado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

addIM(label, address)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega una dirección de MI al contacto con una etiqueta estándar o personalizada.

La etiqueta puede ser de ContactsApp.Field o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and adds the IM address
// "ChatWithJohn" with the ContactsApp.Field.AIM label.
const contacts = ContactsApp.getContactsByName('John Doe');
const email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta de la nueva dirección de MI, ya sea de ContactsApp.Field o de una cadena personalizada
address	String	la nueva dirección de MI

Volver

IMField: Es el campo recién creado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getIMs()

---

addPhone(label, number)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega un número de teléfono al contacto con una etiqueta estándar o personalizada.

La etiqueta puede ser de ContactsApp.Field o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phone = contacts[0].addPhone(
    ContactsApp.Field.WORK_PHONE,
    '212-555-1234',
);

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta del número de teléfono nuevo, ya sea de ContactsApp.Field o de una cadena personalizada
number	String	el número de teléfono nuevo

Volver

PhoneField: Es el campo recién creado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getPhones()

---

addToGroup(group)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega este contacto al grupo de contactos determinado.

// The code below creates a new contact and then adds it to the contact group
// named "Work Friends"
let contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
const group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

Parámetros

Nombre	Tipo	Descripción
group	ContactGroup	el grupo de contactos al que quieres agregarlo

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• removeFromGroup(group)

---

addUrl(label, url)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Agrega una URL al contacto con una etiqueta estándar o personalizada.

La etiqueta puede ser de ContactsApp.Field o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the ContactsApp.Field.WORK_WEBSITE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addUrl(
    ContactsApp.Field.WORK_WEBSITE,
    'http://www.example.com',
);

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta de la dirección nueva, ya sea de ContactsApp.Field o de una cadena personalizada
url	String	la URL nueva

Volver

UrlField: Es el campo recién creado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getUrls()

---

deleteContact()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Borra este contacto.

const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].deleteContact();
}

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getAddresses()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todas las direcciones de este contacto.

// The code below logs the addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

Volver

AddressField[]: Es una lista de direcciones.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addAddress(label, address)

---

getAddresses(label)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todas las direcciones de este contacto que coincidan con un campo en particular.

La etiqueta puede ser de ContactsApp.Field o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (const i in addresses) {
  Logger.log(addresses[i].getAddress());
}

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta que debe coincidir, ya sea de ContactsApp.Field o de una cadena personalizada

Volver

AddressField[]: Es una lista de direcciones.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addAddress(label, address)

---

getCompanies()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todas las empresas de este contacto.

// The code below logs the company names of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  const companies = contacts[i].getCompanies();
  for (const j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

Volver

CompanyField[]: Es una lista de empresas.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addCompany(company, title)

---

getContactGroups()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todos los grupos de contactos que contienen este contacto.

// The code below gets a contact named "John Doe" and retrieves all the contact
// groups that the contact belongs to
const contacts = ContactsApp.getContactsByName('John Doe');
const groups = contacts[0].getContactGroups();

Volver

ContactGroup[]: Los grupos que contienen este contacto

Consulta también

• addToGroup(group)

---

getCustomFields()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todos los campos personalizados de este contacto.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (const i in fields) {
  Logger.log(fields[i].getValue());
}

Volver

CustomField[]: Es una lista de campos personalizados.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addCustomField(label, content)

---

getCustomFields(label)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todos los campos personalizados de este contacto que coincidan con un campo en particular.

La etiqueta puede ser una etiqueta estándar de ContactsApp.ExtendedField o una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact that are in the
// ContactsApp.ExtendedField.HOBBY label.
const contacts = ContactsApp.getContactsByName('John Doe');
const hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (const i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta que debe coincidir, ya sea de ContactsApp.ExtendedField o de una cadena personalizada

Volver

CustomField[]: Es una lista de campos personalizados.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addCustomField(label, content)

---

getDates()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todas las fechas de este contacto.

// The code below retrieves a contact named "John Doe" and logs the label of the
// date associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (const i in dates) {
  Logger.log(dates[i].getLabel());
}

Volver

DateField[]: Es una lista de fechas.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addDate(label, month, day, year)

---

getDates(label)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todas las fechas de este contacto que coincidan con un campo en particular.

La etiqueta puede ser una etiqueta estándar de ContactsApp.Field o una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and logs the day of the
// month associated with that contact that are in the ContactsApp.Field.BIRTHDAY
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (const i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta que debe coincidir, ya sea de ContactsApp.Field o de una cadena personalizada

Volver

DateField[]: Es una lista de fechas.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addDate(label, month, day, year)

---

getEmailAddresses()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene una lista de las direcciones de correo electrónico disponibles para este contacto.

Volver

String[]: Es una lista de las direcciones de correo electrónico disponibles para este contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getEmails()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene las direcciones de correo electrónico de este contacto.

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails();
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

Volver

EmailField[]: Es la lista de direcciones de correo electrónico del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addEmail(label, address)

---

getEmails(label)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene las direcciones de correo electrónico de este contacto que coinciden con un campo en particular.

La etiqueta puede ser una etiqueta estándar de ContactsApp.Field o una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact that are in the
// ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta que debe coincidir, ya sea de ContactsApp.Field o de una cadena personalizada

Volver

EmailField[]: Es la lista de direcciones de correo electrónico del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addEmail(label, address)

---

getFamilyName()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el apellido del contacto como una cadena.

// The code below logs the family name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

Volver

String: Es el apellido del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setFamilyName(familyName)

---

getFullName()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el nombre completo (nombre y apellido) del contacto como una cadena.

// The code below logs the full name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFullName());
}

Volver

String: Es el nombre completo del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setFullName(fullName)

---

getGivenName()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el nombre de pila (nombre) del contacto como una cadena.

// The code below logs the given name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

Volver

String: Es el nombre de pila del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setGivenName(givenName)

---

getHomeAddress()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene la dirección particular de este contacto o una cadena vacía si no existe ninguna.

Volver

String: Es la dirección particular de este contacto o una cadena vacía si no existe ninguna.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getHomeFax()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el número de fax particular de este contacto o una cadena vacía si no existe.

Volver

String: Es el número de fax particular de este contacto o una cadena vacía si no existe.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getHomePhone()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el número de teléfono fijo de este contacto o una cadena vacía si no existe.

Volver

String: Es el número de teléfono fijo de este contacto o una cadena vacía si no existe.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getIMs()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todas las direcciones de MI de este contacto.

// The code below logs the IM addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getIMs());
}

Volver

IMField[]: Es una lista de direcciones de MI.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addIM(label, address)

---

getIMs(label)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todas las direcciones de MI de este contacto que coincidan con un campo en particular.

La etiqueta puede ser de ContactsApp.Field o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (const i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta que debe coincidir, ya sea de ContactsApp.Field o de una cadena personalizada

Volver

IMField[]: Es una lista de direcciones de MI.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addIM(label, address)

---

getId()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Devuelve el ID único de este contacto.

const contact = ContactsApp.createContact(
    'John',
    'Doe',
    '[e-mail]',
);
const id = contact.getId();

Volver

String: Es el ID de este contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getInitials()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene las iniciales del contacto.

// The code below logs the initials of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getInitials());
}

Volver

String: Las iniciales del contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setInitials(initials)

---

getLastUpdated()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene la fecha en la que se actualizó este contacto por última vez.

// The code below logs the last updated date of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

Volver

Date: Es la fecha en la que se actualizó este contacto por última vez.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getMaidenName()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el apellido de soltera del contacto como una cadena.

// The code below logs the maiden name of all the contacts whose names contain
// "Jane"
const contacts = ContactsApp.getContactsByName('Jane');
for (const i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

Volver

String: El apellido de soltera del contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setMaidenName(maidenName)

---

getMiddleName()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el segundo nombre del contacto como una cadena.

// The code below logs the middle name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

Volver

String: Es el segundo nombre del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setMiddleName(middleName)

---

getMobilePhone()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el número de teléfono celular de este contacto o una cadena vacía si no existe.

Volver

String: Es el número de teléfono celular de este contacto o una cadena vacía si no existe.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getNickname()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el sobrenombre del contacto como una cadena.

// The code below logs the nickname of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNickname());
}

Volver

String: Es el sobrenombre del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setNickname(nickname)

---

getNotes()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene las notas asociadas con este contacto o una cadena vacía si no hay notas.

// The code below logs the notes of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNotes());
}

Volver

String: Las notas asociadas con este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setNotes(notes)

---

getPager()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el número de teléfono del buscapersonas de este contacto o una cadena vacía si no existe.

Volver

String: Es el número de teléfono del buscapersonas de este contacto o una cadena vacía si no existe ninguno.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getPhones()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todos los números de teléfono de este contacto.

// The code below logs the phone numbers of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPhones());
}

Volver

PhoneField[]: Es una lista de números de teléfono.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addPhone(label, number)

---

getPhones(label)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todos los números de teléfono de este contacto que coincidan con un campo en particular.

La etiqueta puede ser de ContactsApp.Field o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and logs the phone
// numbers associated with that contact that are in the
// ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (const i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta que debe coincidir, ya sea de ContactsApp.Field o de una cadena personalizada

Volver

PhoneField[]: Es una lista de números de teléfono.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addPhone(label, number)

---

getPrefix()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el prefijo del nombre del contacto.

// The code below logs the prefix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

Volver

String: Es el prefijo del nombre del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setPrefix(prefix)

---

getPrimaryEmail()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene la dirección de correo electrónico principal del contacto como una cadena.

// The code below logs the primary email address of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

Volver

String: Es la dirección de correo electrónico principal del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getShortName()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el nombre corto del contacto como una cadena.

// The code below logs the short name of all the contacts whose names contain
// "Johnathan"
const contacts = ContactsApp.getContactsByName('Johnathan');
for (const i in contacts) {
  Logger.log(contacts[i].getShortName());
}

Volver

String: Es el nombre corto del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setShortName(shortName)

---

getSuffix()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el sufijo del nombre del contacto.

// The code below logs the suffix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

Volver

String: Es el sufijo del nombre del contacto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• setSuffix(suffix)

---

getUrls()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todas las URLs de este contacto.

// The code below logs the URLs of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getUrls());
}

Volver

UrlField[]: Es una lista de URLs.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addUrl(label, url)

---

getUrls(label)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todas las URLs de este contacto que coincidan con un campo en particular.

La etiqueta puede ser de ContactsApp.Field o de una cadena de etiqueta personalizada.

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (const i in urls) {
  Logger.log(urls[i].getAddress());
}

Parámetros

Nombre	Tipo	Descripción
label	Object	la etiqueta que debe coincidir, ya sea de ContactsApp.Field o de una cadena personalizada

Volver

UrlField[]: Es una lista de URLs.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addUrl(label, url)

---

getUserDefinedField(key)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el valor definido por el usuario asociado con la clave determinada.

Parámetros

Nombre	Tipo	Descripción
key	String	La clave puede ser de cualquier tipo básico (String, int, etc.).

Volver

String: Es el contenido definido por el usuario que se almacenó con esta clave.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getUserDefinedFields()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene todos los campos definidos por el usuario para este contacto y los muestra como las propiedades de un objeto de JavaScript.

Volver

Object: Son los campos definidos por el usuario para este contacto, como propiedades de un objeto de JavaScript.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getWorkAddress()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene la dirección de trabajo de este contacto o una cadena vacía si no existe.

Volver

String: Es la dirección de trabajo de este contacto o una cadena vacía si no existe ninguna.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getWorkFax()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el número de fax de trabajo de este contacto o una cadena vacía si no existe.

Volver

String: Es el número de fax de trabajo de este contacto o una cadena vacía si no existe.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

getWorkPhone()

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Obtiene el número de teléfono de trabajo de este contacto o una cadena vacía si no existe.

Volver

String: Es el número de teléfono de trabajo de este contacto o una cadena vacía si no existe.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

removeFromGroup(group)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Quita este contacto del grupo de contactos determinado.

// The code below gets all the contacts named "John Doe" and then removes each
// of them from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

Parámetros

Nombre	Tipo	Descripción
group	ContactGroup	el grupo de contactos del que quieres quitar este contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• addToGroup(group)

---

setFamilyName(familyName)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el apellido del contacto.

// The code below changes the family name of all the contacts whose names are
// "John Doe" to "Doe-Smith"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

Parámetros

Nombre	Tipo	Descripción
familyName	String	el nuevo apellido del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getFamilyName()

---

setFullName(fullName)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el nombre completo (nombre y apellido) del contacto.

// The code below changes the full name of all the contacts whose names are
// "John Doe" to "Johnny Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

Parámetros

Nombre	Tipo	Descripción
fullName	String	el nuevo nombre completo del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getFullName()

---

setGivenName(givenName)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el nombre de pila (nombre) del contacto.

// The code below changes the given name of all the contacts whose names are
// "John Doe" to "Johnny"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setGivenName('Johnny');
}

Parámetros

Nombre	Tipo	Descripción
givenName	String	el nuevo nombre de pila del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getGivenName()

---

setHomeAddress(addr)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece la dirección particular de este contacto.

Parámetros

Nombre	Tipo	Descripción
addr	String	la dirección particular que deseas establecer

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setHomeFax(phone)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el número de fax particular de este contacto.

Parámetros

Nombre	Tipo	Descripción
phone	String	el número de fax de la casa que deseas configurar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setHomePhone(phone)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el número de teléfono particular de este contacto.

Parámetros

Nombre	Tipo	Descripción
phone	String	el número de teléfono particular que deseas configurar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setInitials(initials)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece las iniciales del contacto.

// The code below sets the initials of all the contacts whose names are
// "Johnathan Doe" to "JD"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setInitials('JD');
}

Parámetros

Nombre	Tipo	Descripción
initials	String	las nuevas iniciales del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getInitials()

---

setMaidenName(maidenName)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el apellido de soltera del contacto.

// The code below changes the maiden name of all the contacts whose names are
// "Jane Doe" to "Smith"
const contacts = ContactsApp.getContactsByName('Jane Doe');
for (const i in contacts) {
  contacts[i].setMaidenName('Smith');
}

Parámetros

Nombre	Tipo	Descripción
maidenName	String	el nuevo apellido de soltera del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getMaidenName()

---

setMiddleName(middleName)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el segundo nombre del contacto.

// The code below changes the middle name of all the contacts whose names are
// "John Doe" to "Danger"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setMiddleName('Danger');
}

Parámetros

Nombre	Tipo	Descripción
middleName	String	el nuevo segundo nombre del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getMiddleName()

---

setMobilePhone(phone)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el número de teléfono celular de este contacto.

Parámetros

Nombre	Tipo	Descripción
phone	String	el número de teléfono celular que se establecerá

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setNickname(nickname)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el sobrenombre del contacto.

// The code below changes the nickname of all the contacts whose names are "John
// Doe" to "JohnnyD"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

Parámetros

Nombre	Tipo	Descripción
nickname	String	el nuevo sobrenombre del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getNickname()

---

setNotes(notes)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece las notas asociadas con este contacto.

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

Parámetros

Nombre	Tipo	Descripción
notes	String	las notas que se almacenarán para este contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getNotes()

---

setPager(phone)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el número de buscapersonas de este contacto.

Parámetros

Nombre	Tipo	Descripción
phone	String	el número de paginador que se establecerá

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setPrefix(prefix)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el prefijo en el nombre del contacto.

// The code below sets the prefix of all the contacts whose names are "Johnathan
// Doe" to "Mr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setPrefix('Mr');
}

Parámetros

Nombre	Tipo	Descripción
prefix	String	el nuevo prefijo del nombre del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getPrefix()

---

setPrimaryEmail(primaryEmail)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece la dirección de correo electrónico principal de este contacto.

Parámetros

Nombre	Tipo	Descripción
primaryEmail	String	la dirección de correo electrónico principal que se debe establecer

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setShortName(shortName)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el nombre corto del contacto.

// The code below changes the short name of all the contacts whose names are
// "Johnathan Doe" to "John"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setShortName('John');
}

Parámetros

Nombre	Tipo	Descripción
shortName	String	el nuevo nombre corto del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getShortName()

---

setSuffix(suffix)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el sufijo en el nombre del contacto.

// The code below sets the suffix of all the contacts whose names are "Johnathan
// Doe" to "Jr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setSuffix('Jr');
}

Parámetros

Nombre	Tipo	Descripción
suffix	String	el nuevo sufijo del nombre del contacto

Volver

Contact: Este contacto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

Consulta también

• getSuffix()

---

setUserDefinedField(key, value)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece un solo campo definido por el usuario para este contacto, que se almacenará con una clave determinada.

Parámetros

Nombre	Tipo	Descripción
key	String	La clave puede ser de cualquier tipo básico (String, int, etc.).
value	String	El valor puede ser cualquier tipo básico (String, int, etc.).

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setUserDefinedFields(o)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece los campos definidos por el usuario para este contacto con las propiedades del objeto determinado.

Parámetros

Nombre	Tipo	Descripción
o	Object	Un objeto con una o más propiedades en el formato {clave: valor}

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setWorkAddress(addr)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece la dirección de trabajo de este contacto.

Parámetros

Nombre	Tipo	Descripción
addr	String	la dirección de trabajo que deseas establecer

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setWorkFax(phone)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el número de fax de trabajo de este contacto.

Parámetros

Nombre	Tipo	Descripción
phone	String	el número de fax del trabajo que se establecerá

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds

---

setWorkPhone(phone)

Obsoleto. Esta función dejó de estar disponible y no se debe usar en secuencias de comandos nuevas.

Establece el número de teléfono de trabajo de este contacto.

Parámetros

Nombre	Tipo	Descripción
phone	String	el número de teléfono laboral que deseas configurar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

• https://www.google.com/m8/feeds