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 |
| |
Field |
| |
Gender |
| |
Month | Month | |
Priority |
| |
Sensitivity |
|
Métodos obsoletos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
|
| Crea un contacto nuevo. |
|
| Crea un grupo de contactos con el nombre dado |
| void | Borra el contacto. |
| void | Borra el grupo de contactos |
|
| Encuentra un contacto con la dirección de correo electrónico indicada. |
|
| Busca un grupo de contactos con el nombre indicado. |
|
| Obtén todos los contactos que pertenecen a este usuario. |
|
| Obtiene un contacto por la dirección de correo electrónico. |
|
| Obtiene el contacto con este ID. |
|
| Obtiene un grupo de contactos con el nombre dado o muestra un valor nulo si no se encuentra dicho grupo. |
|
| Obtiene un grupo de contactos con el ID indicado o muestra un resultado nulo si no se encuentra dicho grupo. |
|
| Obtiene la lista completa de los grupos de contactos del usuario. |
|
| Obtiene todos los contactos del usuario. |
|
| Obtén contactos que coincidan con una dirección. |
|
| Obtener los contactos que coinciden con una dirección, limitados a un campo específico |
|
| Obtén los contactos que coinciden con una dirección, limitada a la etiqueta de dirección personalizada especificada. |
|
| Obtén contactos que coincidan con el campo de la empresa. |
|
| Obtén los contactos que coincidan con un valor determinado en un campo personalizado. |
|
| Obtén los contactos que coincidan con un mes y un día determinados para un campo estándar específico. |
|
| Obtén los contactos que coincidan con un mes, un día y un año determinados para un campo estándar específico. |
|
| Obtén los contactos que coincidan con un mes, día y año determinados para un campo personalizado en particular. |
|
| Obtén los contactos que coincidan con un mes y un día determinados para un campo personalizado en particular. |
|
| Obtén contactos que coinciden con una dirección de correo electrónico. |
|
| Obtener contactos que coincidan con una dirección de correo electrónico, limitados a un campo específico |
|
| 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ó. |
|
| Obtiene los contactos de un ContactGroup determinado. |
|
| Obtén contactos que coinciden con una dirección de mensajería instantánea. |
|
| Obtén contactos que coincidan con una dirección de mensajería instantánea, limitada a un campo específico. |
|
| Obtiene contactos que coinciden con una dirección de mensajería instantánea, limitada a la etiqueta de mensajería instantánea personalizada especificada. |
|
| Obtén contactos que coincidan con el campo de cargo. |
|
| Obtén contactos que coinciden con un nombre. |
|
| Obtén los contactos que coinciden con un nombre, limitados a un campo específico. |
|
| Haz que los contactos coincidan con el campo de notas. |
|
| Obtén los contactos que coinciden con un número de teléfono. |
|
| Obtener contactos que coincidan con un número de teléfono, limitados a un campo específico |
|
| Obtiene los contactos que coinciden con un número de teléfono, limitado a la etiqueta personalizada del número de teléfono. |
|
| Obtén los contactos que coinciden con una URL. |
|
| Obtén los contactos que coinciden con una URL, limitada a un campo específico. |
|
| Obtén los contactos que coinciden con una URL, limitada a la etiqueta de URL personalizada especificada. |
Métodos obsoletos
createContact(givenName, familyName, email)
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
: Es el objeto Contact recién creado.Contact
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)
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
: Es el grupo de contactos recién creado.ContactGroup
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)
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 |
| 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
deleteContactGroup(group)
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 |
| 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
findByEmailAddress(email)
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
: Es el contacto que contiene esa dirección de correo electrónico.Contact
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)
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
: Es el grupo de contactos que coincide con el nombre determinado.ContactGroup
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()
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
: Todos los contactos de este usuarioContact[]
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)
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
: Es el contacto que contiene esa dirección de correo electrónico.Contact
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
getContactById(id)
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
: Es el contacto coincidente o el valor nulo.Contact
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)
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
: Es el grupo de contactos coincidente o nulo si no se encuentra ningún grupo de contactos que coincida.ContactGroup
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
getContactGroupById(id)
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
: Es el grupo de contactos coincidente o nulo si no se encuentra ningún grupo de contactos que coincida.ContactGroup
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
: Es un array de los grupos de contactos del usuario.ContactGroup[]
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
getContacts()
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
: Es un array de todos los contactos del usuario.Contact[]
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
getContactsByAddress(query)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByAddress(query, label)
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 |
| el campo para buscar dentro |
Devolvedor
: Es un array de contactos coincidentes.Contact[]
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
getContactsByAddress(query, label)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByCompany(query)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByCustomField(query, label)
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 |
| el campo personalizado para buscar dentro |
Devolvedor
: Es un array de contactos coincidentes.Contact[]
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
getContactsByDate(month, day, label)
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 |
| el campo dentro del cual buscar, desde ContactsApp.Field |
Devolvedor
: Es un array de contactos coincidentes.Contact[]
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
getContactsByDate(month, day, year, label)
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 |
| el campo dentro del cual buscar, desde ContactsApp.Field |
Devolvedor
: Es un array de contactos coincidentes.Contact[]
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
getContactsByDate(month, day, year, label)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByDate(month, day, label)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByEmailAddress(query)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByEmailAddress(query, label)
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 |
| el campo para buscar dentro |
Devolvedor
: Es un array de contactos coincidentes.Contact[]
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
getContactsByEmailAddress(query, label)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByGroup(group)
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 |
| el grupo de contactos |
Devolvedor
: Es un array de contactos en el grupo determinado.Contact[]
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
getContactsByIM(query)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByIM(query, label)
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 |
| el campo para buscar dentro |
Devolvedor
: Es un array de contactos coincidentes.Contact[]
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
getContactsByIM(query, label)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByJobTitle(query)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByName(query)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByName(query, label)
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 |
| el campo para buscar dentro |
Devolvedor
: Es un array de contactos coincidentes.Contact[]
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
getContactsByNotes(query)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByPhone(query)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByPhone(query, label)
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 |
| el campo para buscar dentro |
Devolvedor
: Es un array de contactos coincidentes.Contact[]
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
getContactsByPhone(query, label)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByUrl(query)
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
: Es un array de contactos coincidentes.Contact[]
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
getContactsByUrl(query, label)
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 |
| el campo para buscar dentro |
Devolvedor
: Es un array de contactos coincidentes.Contact[]
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
getContactsByUrl(query, label)
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
: Es un array de contactos coincidentes.Contact[]
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