Obsoleto. En su lugar, usa el servicio avanzado de la API de People.
Un Grupo de contactos es un grupo de contactos.
Métodos obsoletos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
|
| Agrega el contacto determinado a este grupo |
| void | Borra este grupo de contactos. |
|
| Obtiene todos los contactos de este grupo de contactos. |
| String | Muestra el nombre de este grupo. |
| String | Obtiene el ID de este grupo de contactos. |
| String | Obtiene el nombre de este grupo de contactos. |
| Boolean | Obtiene un valor booleano para determinar si este grupo de contactos es un grupo del sistema (no se puede borrar) o no. |
|
| Quita el contacto proporcionado de este grupo |
| void | Establece el nombre de este grupo. |
|
| Establece el nombre de este grupo de contactos. |
Métodos obsoletos
addContact(contact)
addContact(contact)
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Agrega el contacto determinado a este grupo
// The code below creates a new contact and adds it to the "Work Friends" contact group var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com'); var group = ContactsApp.getContactGroup('Work Friends'); group.addContact(contact);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
contact |
| el contacto que se agregará al grupo. |
Devolvedor
: Este grupo de contactosContactGroup
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
deleteGroup()
deleteGroup()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Borra este grupo de contactos.
Borra solo los grupos que no son del sistema. No se pueden borrar los grupos del sistema.
// The code below retrieves a contact group named "Work Friends" and deletes it var group = ContactsApp.getContactGroup('Work Friends'); group.deleteGroup();
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 de este grupo de contactos.
// The code below retrieves all the contacts in the group named "Work Friends" var group = ContactsApp.getContactGroup('Work Friends'); var contacts = group.getContacts();
Devolvedor
: Son los contactos de este grupo.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
getGroupName()
getGroupName()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Muestra el nombre de este grupo.
Devolvedor
String
: Es el nombre de este grupo.
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
getId()
getId()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Obtiene el ID de este grupo de contactos.
// The code below retrieves a contact group named "Work Friends" and gets its id var group = ContactsApp.getContactGroup('Work Friends'); var id = group.getId();
Devolvedor
String
: Es el ID de este grupo.
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
getName()
getName()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Obtiene el nombre de este grupo de contactos.
// The code below creates a new contact group and then retrieves its name var group = ContactsApp.createContactGroup('Work Friends'); var name = group.getName();
Devolvedor
String
: Este nombre de este grupo de contactos
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
isSystemGroup()
isSystemGroup()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Obtiene un valor booleano para determinar si este grupo de contactos es un grupo del sistema (no se puede borrar) o no.
Los grupos de sistemas son un conjunto de grupos predefinidos en Contactos de Google, como "Mis contactos", "Familia", "Compañeros de trabajo", etc. Por lo general, el nombre de un grupo del sistema contiene las palabras "Grupo del sistema".
// The code below retrieves two contact groups, then logs whether or not // each is a system group. var myGroup = ContactsApp.getContactGroup('Work Friends'); var systemGroup = ContactsApp.getContactGroup('System Group: Coworkers'); Logger.log(myGroup.isSystemGroup()); // Returns false, if the group exists. Logger.log(systemGroup.isSystemGroup()); // Returns true.
Devolvedor
Boolean
: Indica si este grupo de contactos es o no un grupo del sistema.
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
removeContact(contact)
removeContact(contact)
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Quita el contacto proporcionado de este grupo
// The code below retrieves all the contacts named "John Doe' and removes them from the // "Work Friends" contact group var contacts = ContactsApp.getContactsByName('John Doe'); var group = ContactsApp.getContactGroup('Work Friends'); for (var i in contacts) { group.removeContact(contacts[i]); }
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
contact |
| el contacto que se quitará del grupo |
Devolvedor
: Este grupo de contactosContactGroup
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
setGroupName(name)
setGroupName(name)
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Establece el nombre de este grupo.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
name | String | el nombre que se establecerá para este grupo |
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
setName(name)
setName(name)
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Establece el nombre de este grupo de contactos.
// The code below retrieves the contact group named "Work Friends" and renames it to // "Work Buddies" var group = ContactsApp.getContactGroup('Work Friends'); group.setName('Work Buddies');
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
name | String | el nombre nuevo del grupo de contactos |
Devolvedor
: Este grupo de contactosContactGroup
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