Obsoleta. Utilizza invece il servizio avanzato API People
Un gruppo di contatti è un gruppo di contatti.
Metodi deprecati
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
|
| Aggiunge il contatto specificato a questo gruppo |
| void | Elimina questo gruppo di contatti. |
|
| Recupera tutti i contatti in questo gruppo di contatti. |
| String | Restituisce il nome di questo gruppo. |
| String | Ottieni l'ID di questo gruppo di contatti. |
| String | Consente di acquisire il nome di questo gruppo di contatti. |
| Boolean | Restituisce un valore booleano per determinare se questo gruppo di contatti è un gruppo di sistema (non selezionabile) o meno. |
|
| Rimuove il contatto specificato da questo gruppo |
| void | Imposta il nome di questo gruppo. |
|
| Imposta il nome di questo gruppo di contatti. |
Metodi deprecati
addContact(contact)
addContact(contact)
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Aggiunge il contatto specificato a questo gruppo
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contact |
| il contatto da aggiungere al gruppo |
Ritorni
- questo gruppo di contattiContactGroup
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds
Vedi anche
deleteGroup()
deleteGroup()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Elimina questo gruppo di contatti.
Elimina solo i gruppi non di sistema; i gruppi di sistema non possono essere eliminati.
// The code below retrieves a contact group named "Work Friends" and deletes it var group = ContactsApp.getContactGroup('Work Friends'); group.deleteGroup();
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds
Vedi anche
getContacts()
getContacts()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Recupera tutti i contatti in questo gruppo di contatti.
// The code below retrieves all the contacts in the group named "Work Friends" var group = ContactsApp.getContactGroup('Work Friends'); var contacts = group.getContacts();
Ritorni
: i contatti in questo gruppoContact[]
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds
getGroupName()
getGroupName()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Restituisce il nome di questo gruppo.
Ritorni
String
: il nome di questo gruppo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds
getId()
getId()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Ottieni l'ID di questo gruppo di contatti.
// The code below retrieves a contact group named "Work Friends" and gets its id var group = ContactsApp.getContactGroup('Work Friends'); var id = group.getId();
Ritorni
String
: l'ID di questo gruppo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds
getName()
getName()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Consente di acquisire il nome di questo gruppo di contatti.
// The code below creates a new contact group and then retrieves its name var group = ContactsApp.createContactGroup('Work Friends'); var name = group.getName();
Ritorni
String
- questo nome di questo gruppo di contatti
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds
Vedi anche
isSystemGroup()
isSystemGroup()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Restituisce un valore booleano per determinare se questo gruppo di contatti è un gruppo di sistema (non selezionabile) o meno.
I gruppi di sistema sono un insieme di gruppi predefiniti in Contatti Google, ad esempio "Contatti", "Famiglia", "Collaboratori" e così via. In genere, il nome di un gruppo di sistema contiene le parole "Gruppo di 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.
Ritorni
Boolean
: se questo gruppo di contatti è un gruppo di sistema o meno
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds
removeContact(contact)
removeContact(contact)
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Rimuove il contatto specificato da questo gruppo
// 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]); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contact |
| il contatto da rimuovere dal gruppo |
Ritorni
- questo gruppo di contattiContactGroup
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds
Vedi anche
setGroupName(name)
setGroupName(name)
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Imposta il nome di questo gruppo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome da impostare per questo gruppo |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds
setName(name)
setName(name)
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Imposta il nome di questo gruppo di contatti.
// 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');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nuovo nome del gruppo di contatti |
Ritorni
- questo gruppo di contattiContactGroup
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.google.com/m8/feeds