Se usó la API de Cloud Translation para traducir esta página.

Class ContactsApp

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

Esta clase permite a los usuarios acceder a sus propios Contactos de Google y crear, quitar y actualizar los contactos que se indican allí.

Propiedades obsoletas

Propiedad	Tipo	Descripción
`ExtendedField`	`ExtendedField`
`Field`	`Field`
`Gender`	`Gender`
`Month`	`Month`
`Priority`	`Priority`
`Sensitivity`	`Sensitivity`

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
`createContact(givenName, familyName, email)`	`Contact`	Crea un contacto nuevo.
`createContactGroup(name)`	`ContactGroup`	Crea un grupo de contactos con el nombre dado
`deleteContact(contact)`	`void`	Borra el contacto.
`deleteContactGroup(group)`	`void`	Borra el grupo de contactos
`findByEmailAddress(email)`	`Contact`	Encuentra un contacto con la dirección de correo electrónico indicada.
`findContactGroup(name)`	`ContactGroup`	Busca un grupo de contactos con el nombre indicado.
`getAllContacts()`	`Contact[]`	Obtén todos los contactos que pertenecen a este usuario.
`getContact(emailAddress)`	`Contact`	Obtiene un contacto por la dirección de correo electrónico.
`getContactById(id)`	`Contact`	Obtiene el contacto con este ID.
`getContactGroup(name)`	`ContactGroup`	Obtiene un grupo de contactos con el nombre dado o muestra un valor nulo si no se encuentra dicho grupo.
`getContactGroupById(id)`	`ContactGroup`	Obtiene un grupo de contactos con el ID indicado o muestra un resultado nulo si no se encuentra dicho grupo.
`getContactGroups()`	`ContactGroup[]`	Obtiene la lista completa de los grupos de contactos del usuario.
`getContacts()`	`Contact[]`	Obtiene todos los contactos del usuario.
`getContactsByAddress(query)`	`Contact[]`	Obtén contactos que coincidan con una dirección.
`getContactsByAddress(query, label)`	`Contact[]`	Obtener los contactos que coinciden con una dirección, limitados a un campo específico
`getContactsByAddress(query, label)`	`Contact[]`	Obtén los contactos que coinciden con una dirección, limitada a la etiqueta de dirección personalizada especificada.
`getContactsByCompany(query)`	`Contact[]`	Obtén contactos que coincidan con el campo de la empresa.
`getContactsByCustomField(query, label)`	`Contact[]`	Obtén los contactos que coincidan con un valor determinado en un campo personalizado.
`getContactsByDate(month, day, label)`	`Contact[]`	Obtén los contactos que coincidan con un mes y un día determinados para un campo estándar específico.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Obtén los contactos que coincidan con un mes, un día y un año determinados para un campo estándar específico.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Obtén los contactos que coincidan con un mes, día y año determinados para un campo personalizado en particular.
`getContactsByDate(month, day, label)`	`Contact[]`	Obtén los contactos que coincidan con un mes y un día determinados para un campo personalizado en particular.
`getContactsByEmailAddress(query)`	`Contact[]`	Obtén contactos que coinciden con una dirección de correo electrónico.
`getContactsByEmailAddress(query, label)`	`Contact[]`	Obtener contactos que coincidan con una dirección de correo electrónico, limitados a un campo específico
`getContactsByEmailAddress(query, label)`	`Contact[]`	Obtener los contactos que coinciden con una dirección de correo electrónico, limitada a la etiqueta de dirección de correo electrónico personalizada que se especificó.
`getContactsByGroup(group)`	`Contact[]`	Obtiene los contactos de un ContactGroup determinado.
`getContactsByIM(query)`	`Contact[]`	Obtén contactos que coinciden con una dirección de mensajería instantánea.
`getContactsByIM(query, label)`	`Contact[]`	Obtén contactos que coincidan con una dirección de mensajería instantánea, limitada a un campo específico.
`getContactsByIM(query, label)`	`Contact[]`	Obtiene contactos que coinciden con una dirección de mensajería instantánea, limitada a la etiqueta de mensajería instantánea personalizada especificada.
`getContactsByJobTitle(query)`	`Contact[]`	Obtén contactos que coincidan con el campo de cargo.
`getContactsByName(query)`	`Contact[]`	Obtén contactos que coinciden con un nombre.
`getContactsByName(query, label)`	`Contact[]`	Obtén los contactos que coinciden con un nombre, limitados a un campo específico.
`getContactsByNotes(query)`	`Contact[]`	Haz que los contactos coincidan con el campo de notas.
`getContactsByPhone(query)`	`Contact[]`	Obtén los contactos que coinciden con un número de teléfono.
`getContactsByPhone(query, label)`	`Contact[]`	Obtener contactos que coincidan con un número de teléfono, limitados a un campo específico
`getContactsByPhone(query, label)`	`Contact[]`	Obtiene los contactos que coinciden con un número de teléfono, limitado a la etiqueta personalizada del número de teléfono.
`getContactsByUrl(query)`	`Contact[]`	Obtén los contactos que coinciden con una URL.
`getContactsByUrl(query, label)`	`Contact[]`	Obtén los contactos que coinciden con una URL, limitada a un campo específico.
`getContactsByUrl(query, label)`	`Contact[]`	Obtén los contactos que coinciden con una URL, limitada a la etiqueta de URL personalizada especificada.

Métodos obsoletos

`createContact(givenName, familyName, email)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Crea un contacto nuevo.

// The code below creates a new contact with the name "John Doe" and the email address
// "john.doe@example.com".
var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');

Parámetros

Nombre	Tipo	Descripción
`givenName`	`String`	el nombre del contacto
`familyName`	`String`	el apellido del contacto
`email`	`String`	la dirección de correo electrónico del contacto

Devolvedor

Contact: Es el objeto Contact 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 alcances:

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

Consulta también

deleteContact(contact)

`createContactGroup(name)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Crea un grupo de contactos con el nombre dado

// The code below creates a new contact group named "Work Friends"
var group = ContactsApp.createContactGroup("Work Friends");

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	el nombre del nuevo grupo de contactos

Devolvedor

ContactGroup: Es el grupo de contactos 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 alcances:

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

Consulta también

deleteContactGroup(group)

`deleteContact(contact)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Borra el contacto.

// The code below retrieves a contact with the email address "john.doe@example.com"
// and then deletes that contact.
var contact = ContactsApp.getContact('john.doe@example.com');
ContactsApp.deleteContact(contact);

Parámetros

Nombre	Tipo	Descripción
`contact`	`Contact`	el contacto que se borrará

Autorización

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

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

Consulta también

createContact(givenName, familyName, email)

`deleteContactGroup(group)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Borra el grupo de contactos

// The code below creates deletes the contact group named "Work Friends"
var group = ContactsApp.getContactGroup("Work Friends");
ContactsApp.deleteContactGroup(group);

Parámetros

Nombre	Tipo	Descripción
`group`	`ContactGroup`	el grupo de contactos que quieres borrar

Autorización

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

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

Consulta también

createContactGroup(name)

`findByEmailAddress(email)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Encuentra un contacto con la dirección de correo electrónico indicada.

Parámetros

Nombre	Tipo	Descripción
`email`	`String`	la dirección de correo electrónico del contacto que se debe encontrar

Devolvedor

Contact: Es el contacto que contiene esa dirección de correo electrónico.

Autorización

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

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

`findContactGroup(name)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Busca un grupo de contactos con el nombre indicado.

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	el nombre del grupo de contactos para buscar

Devolvedor

ContactGroup: Es el grupo de contactos que coincide con el nombre determinado.

Autorización

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

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

`getAllContacts()`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén todos los contactos que pertenecen a este usuario.

Devolvedor

Contact[]: Todos los contactos de este usuario

Autorización

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

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

`getContact(emailAddress)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtiene un contacto por la dirección de correo electrónico.

Si varios contactos comparten la misma dirección de correo electrónico, el método favorece a los contactos que hayan marcado la dirección de correo electrónico como principal. Si ninguno de los contactos tenía la dirección de correo electrónico marcada como principal o varios contactos tenían la dirección de correo electrónico marcada como principal, se muestra el primer resultado en el orden de los contactos ordenados.

// The code below retrieves a contact with the email address "john.doe@example.com".
var contact = ContactsApp.getContact('john.doe@example.com');

Parámetros

Nombre	Tipo	Descripción
`emailAddress`	`String`	la dirección de correo electrónico del contacto

Devolvedor

Contact: Es el contacto que contiene esa dirección de correo electrónico.

Autorización

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

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

`getContactById(id)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtiene el contacto con este ID.

// The code below retrieves the contact with the id
// "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5"
var id = 'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
var contact = ContactApp.getContactById(id);

Parámetros

Nombre	Tipo	Descripción
`id`	`String`	el ID del contacto que se recuperará

Devolvedor

Contact: Es el contacto coincidente o el valor nulo.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactGroup(name)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtiene un grupo de contactos con el nombre dado o muestra un valor nulo si no se encuentra dicho grupo.

// The code below returns the contact group with the name "Work Friends"
var group  = ContactsApp.getContactGroup('Work Friends');

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	el nombre del grupo de contactos con el que debe coincidir

Devolvedor

ContactGroup: Es el grupo de contactos coincidente o nulo si no se encuentra ningún grupo de contactos que coincida.

Autorización

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

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

Consulta también

getContactGroups()

`getContactGroupById(id)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtiene un grupo de contactos con el ID indicado o muestra un resultado nulo si no se encuentra dicho grupo.

// The code below returns the contact group with the id
// "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"
var id = "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb";
var group  = ContactsApp.getContactGroupById(id);

Parámetros

Nombre	Tipo	Descripción
`id`	`String`	el ID del grupo de contactos que debe coincidir

Devolvedor

ContactGroup: Es el grupo de contactos coincidente o nulo si no se encuentra ningún grupo de contactos que coincida.

Consulta también

getContactGroups()

`getContactGroups()`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtiene la lista completa de los grupos de contactos del usuario.

Un usuario puede tener una lista de contactos y, posiblemente, una lista de grupos de contactos. Cada Grupo de contactos puede contener contactos. Este método devuelve una lista de todos los grupos de contactos.

// The retrieves all the contract groups for the user and then logs the group name of each
// contact group.
var groups  = ContactsApp.getContactGroups();
for (var i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

Devolvedor

ContactGroup[]: Es un array de los grupos de contactos del usuario.

Autorización

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

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

Consulta también

getContactGroup(name)

`getContacts()`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtiene todos los contactos del usuario.

// The code below will retrieve all the user's contacts
var contacts = ContactsApp.getContacts();

Devolvedor

Contact[]: Es un array de todos los contactos del usuario.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByAddress(query)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén contactos que coincidan con una dirección.

// The code below returns an array of contacts where the contact's address contains
// "San Francisco'.
var contacts = ContactsApp.getContactsByAddress('San Francisco');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en las direcciones del contacto

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByAddress(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtener los contactos que coinciden con una dirección, limitados a un campo específico

// The code below returns an array of contacts where the contact's address contains
// "San Francisco" in the Home address field.
var contacts = ContactsApp.getContactsByAddress('San Francisco',
                                                ContactsApp.Field.HOME_ADDRESS);

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en las direcciones del contacto
`label`	`Field`	el campo para buscar dentro

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByAddress(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coinciden con una dirección, limitada a la etiqueta de dirección personalizada especificada.

// The code below returns an array of contacts where the contact's address contains
// "San Francisco" in a custom address label (created by the user) called
// "vacation".
var contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la string que se buscará en las direcciones del contacto con la etiqueta de dirección personalizada especificada
`label`	`String`	la etiqueta de dirección personalizada para buscar

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByCompany(query)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén contactos que coincidan con el campo de la empresa.

// The code below returns an array of contacts where the contact's company field
// contains "Google".
var contacts = ContactsApp.getContactsByCompany('Google');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	La cadena que se buscará en el campo de la empresa del contacto

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByCustomField(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coincidan con un valor determinado en un campo personalizado.

El campo personalizado se puede especificar mediante una cadena o como uno de los valores ContactsApp.ExtendedField.

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
var contacts = ContactsApp.getContactsByCustomField('tennis', 'Favorite Sport');

Parámetros

Nombre	Tipo	Descripción
`query`	`Object`	la cadena que se buscará en el campo personalizado del contacto
`label`	`ExtendedField`	el campo personalizado para buscar dentro

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByDate(month, day, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coincidan con un mes y un día determinados para un campo estándar específico.

// The code below returns an array of contacts where the contact's "Birthday" field
// contains April for the month and 19 for the day.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19,
                                              ContactsApp.Field.BIRTHDAY);

Parámetros

Nombre	Tipo	Descripción
`month`	`Month`	el mes debe coincidir, como uno de los valores de ContactsApp.Month.
`day`	`Integer`	el día para coincidir
`label`	`Field`	el campo dentro del cual buscar, desde ContactsApp.Field

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coincidan con un mes, un día y un año determinados para un campo estándar específico.

// The code below returns an array of contacts where the contact's "Birthday" field
// contains April for the month, 19 for the day, and 1950 for the year.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 1950,
                                             ContactsApp.Field.BIRTHDAY);

Parámetros

Nombre	Tipo	Descripción
`month`	`Month`	el mes debe coincidir, como uno de los valores de ContactsApp.Month.
`day`	`Integer`	el día para coincidir
`year`	`Integer`	el año para que coincida, puede ser nulo
`label`	`Field`	el campo dentro del cual buscar, desde ContactsApp.Field

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coincidan con un mes, día y año determinados para un campo personalizado en particular.

// The code below returns an array of contacts where the contact's custom "Start Date" field
// contains April for the month, 19 for the day, and 2011 for the year.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 2011, 'Start Date');

Parámetros

Nombre	Tipo	Descripción
`month`	`Month`	el mes debe coincidir, como uno de los valores de ContactsApp.Month.
`day`	`Integer`	el día para coincidir
`year`	`Integer`	el año para que coincida, puede ser nulo
`label`	`String`	el campo personalizado para buscar dentro

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByDate(month, day, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coincidan con un mes y un día determinados para un campo personalizado en particular.

// The code below returns an array of contacts where the contact's custom "Start Date" field
// contains April for the month and 19 for the day.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 'Start Date');

Parámetros

Nombre	Tipo	Descripción
`month`	`Month`	el mes debe coincidir, como uno de los valores de ContactsApp.Month.
`day`	`Integer`	el día para coincidir
`label`	`String`	el campo personalizado para buscar dentro

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByEmailAddress(query)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén contactos que coinciden con una dirección de correo electrónico.

// The code below returns an array of contacts where the contact's email address contains
// "john.doe@example.com'.
var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en las direcciones de correo electrónico de contacto

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtener contactos que coincidan con una dirección de correo electrónico, limitados a un campo específico

// The code below returns an array of contacts where the contact's email address contains
// "john.doe@example.com" in the Home email field.
var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com',
                                                     ContactsApp.Field.HOME_EMAIL);

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en las direcciones de correo electrónico de contacto
`label`	`Field`	el campo para buscar dentro

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtener los contactos que coinciden con una dirección de correo electrónico, limitada a la etiqueta de dirección de correo electrónico personalizada que se especificó.

// The code below returns an array of contacts where the contact's email address contains
// "john.doe@example.com" in a custom email address label (created by the user) called
// "alternate".
var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com', 'alternate');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la string que se buscará en las direcciones de correo electrónico de contacto con la etiqueta de dirección de correo electrónico personalizada que se especificó
`label`	`String`	la etiqueta de dirección de correo electrónico personalizada para buscar

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByGroup(group)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtiene los contactos de un ContactGroup determinado.

// The code below returns an array of contacts in the ContactGroup with the name
// "Work Friends".
var group  = ContactsApp.getContactGroup('Work Friends');
var contacts = ContactsApp.getContactsByGroup(group);

Parámetros

Nombre	Tipo	Descripción
`group`	`ContactGroup`	el grupo de contactos

Devolvedor

Contact[]: Es un array de contactos en el grupo determinado.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByIM(query)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén contactos que coinciden con una dirección de mensajería instantánea.

// The code below returns an array of contacts where the contact's instant messaging address
// contains "ChatWithJohnDoe" in any instant messaging field.
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se utiliza para buscar las direcciones de mensajería instantánea del contacto

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByIM(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén contactos que coincidan con una dirección de mensajería instantánea, limitada a un campo específico.

// The code below returns an array of contacts where the contact's instant messaging address
// contains "ChatWithJohnDoe" in the AIM instant messaging field.
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe',
                                            ContactsApp.Field.AIM);

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se utiliza para buscar las direcciones de mensajería instantánea del contacto
`label`	`Field`	el campo para buscar dentro

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByIM(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtiene contactos que coinciden con una dirección de mensajería instantánea, limitada a la etiqueta de mensajería instantánea personalizada especificada.

// The code below returns an array of contacts where the contact's instant messaging address
// contains "ChatWithJohnDoe" in a custom instant messaging label (created by the user) called
// "eBuddy".
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en las direcciones de mensajería instantánea del contacto con la etiqueta de mensajería instantánea personalizada especificada.
`label`	`String`	la etiqueta de mensajería instantánea personalizada para buscar

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByJobTitle(query)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén contactos que coincidan con el campo de cargo.

// The code below returns an array of contacts where the contact's job title field
// contains "Product Manager".
var contacts = ContactsApp.getContactsByJobTitle('Product Manager');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en el campo de cargo del contacto.

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByName(query)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén contactos que coinciden con un nombre.

// The code below returns an array of contacts where the contact name contains "John"
var contacts = ContactsApp.getContactsByName('John');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en los nombres de los contactos

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByName(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coinciden con un nombre, limitados a un campo específico.

// The code below returns an array of contacts where the contact name contains "John"
// in the Given Name field.
var contacts = ContactsApp.getContactsByName('John', ContactsApp.Field.GIVEN_NAME);

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en los nombres de los contactos
`label`	`Field`	el campo para buscar dentro

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByNotes(query)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Haz que los contactos coincidan con el campo de notas.

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
var contacts = ContactsApp.getContactsByNotes('sent birthday card');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en el campo de notas del contacto

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByPhone(query)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coinciden con un número de teléfono.

Este método expandirá los números de teléfono con letras, de modo que si buscas "212-555-CODE" y tienes "212-555-2633" en tus contactos, o viceversa, el método encontrará el contacto adecuado.

// The code below returns an array of contacts where the contact's phone number contains
// "212-555-1234' in any phone number field.
var contacts = ContactsApp.getContactsByPhone('212-555-1234');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se debe buscar en los números de teléfono del contacto

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByPhone(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtener contactos que coincidan con un número de teléfono, limitados a un campo específico

Este método expandirá los números de teléfono con letras, de modo que si buscas "212-555-CODE" y tienes "212-555-2633" en tus contactos, o viceversa, el método encontrará el contacto adecuado.

// The code below returns an array of contacts where the contact's phone number contains
// "212-555-1234" in the Home phone number field.
var contacts = ContactsApp.getContactsByPhone('212-555-1234',
                                              ContactsApp.Field.HOME_PHONE);

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se debe buscar en los números de teléfono del contacto
`label`	`Field`	el campo para buscar dentro

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByPhone(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtiene los contactos que coinciden con un número de teléfono, limitado a la etiqueta personalizada del número de teléfono.

Este método expandirá los números de teléfono con letras, de modo que si buscas "212-555-CODE" y tienes "212-555-2633" en tus contactos, o viceversa, el método encontrará el contacto adecuado.

// The code below returns an array of contacts where the contact's phone number contains
// "212-555-1234" in a custom phone number label (created by the user) called
// "alternate".
var contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	Es la cadena que se buscará en los números de teléfono del contacto con la etiqueta de número de teléfono personalizado que se especificó.
`label`	`String`	la etiqueta personalizada del número de teléfono para buscar

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByUrl(query)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coinciden con una URL.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com' in any URL field.
var contacts = ContactsApp.getContactsByUrl('www.example.com');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	La cadena que se buscará en las URLs del contacto

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByUrl(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coinciden con una URL, limitada a un campo específico.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in the Work URL field.
var contacts = ContactsApp.getContactsByUrl('www.example.com',
                                            ContactsApp.Field.WORK_WEBSITE);

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	La cadena que se buscará en las URLs del contacto
`label`	`Field`	el campo para buscar dentro

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)

`getContactsByUrl(query, label)`

Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.

Obtén los contactos que coinciden con una URL, limitada a la etiqueta de URL personalizada especificada.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in a custom URL label (created by the user) called
// "alternate work".
var contacts = ContactsApp.getContactsByUrl('www.example.com', 'alternate work');

Parámetros

Nombre	Tipo	Descripción
`query`	`String`	la cadena que se buscará en las URLs del contacto con la etiqueta de URL personalizada especificada
`label`	`String`	la etiqueta de URL personalizada para buscar en

Devolvedor

Contact[]: Es un array de contactos coincidentes.

Autorización

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

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

Consulta también

getContact(emailAddress)