Class ContactGroup

Gruppodi contatto

Ritiro. Utilizza invece il servizio avanzato dell'API People

Un ContactGroup è un gruppo di contatti.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
addContact(contact)	ContactGroup	Aggiunge il contatto specificato a questo gruppo // The code below creates a new contact and adds it to the "Work Friends" // contact group const contact = ContactsApp.createContact( 'John', 'Doe', '[e-mail]', ); const group = ContactsApp.getContactGroup('Work Friends'); group.addContact(contact);
deleteGroup()	void	Consente di eliminare questo gruppo di contatti.
getContacts()	Contact[]	Recupera tutti i contatti di questo gruppo di contatti.
getGroupName()	String	Restituisce il nome di questo gruppo.
getId()	String	Recupera l'ID di questo gruppo di contatti.
getName()	String	Restituisce il nome di questo gruppo di contatti.
isSystemGroup()	Boolean	Restituisce un valore booleano per determinare se questo gruppo di contatti è un gruppo di sistema (non eliminabile) o meno.
removeContact(contact)	ContactGroup	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 const contacts = ContactsApp.getContactsByName('John Doe'); const group = ContactsApp.getContactGroup('Work Friends'); for (const i in contacts) { group.removeContact(contacts[i]); }
setGroupName(name)	void	Imposta il nome di questo gruppo.
setName(name)	ContactGroup	Imposta il nome di questo gruppo di contatti.

Metodi ritirati

addContact(contact)

Ritiro. 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
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    '[e-mail]',
);
const group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);

Parametri

Nome	Tipo	Descrizione
contact	Contact	Il contatto da aggiungere al gruppo

Invio

ContactGroup: 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

• removeContact(contact)

---

deleteGroup()

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Consente di eliminare questo gruppo di contatti.

Consente di eliminare 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
const 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

• isSystemGroup()

---

getContacts()

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Recupera tutti i contatti di questo gruppo di contatti.

// The code below retrieves all the contacts in the group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = group.getContacts();

Invio

Contact[]: i contatti in 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

---

getGroupName()

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce il nome di questo gruppo.

Invio

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()

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Recupera l'ID di questo gruppo di contatti.

// The code below retrieves a contact group named "Work Friends" and gets its id
const group = ContactsApp.getContactGroup('Work Friends');
const id = group.getId();

Invio

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()

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce il nome di questo gruppo di contatti.

// The code below creates a new contact group and then retrieves its name
const group = ContactsApp.createContactGroup('Work Friends');
const name = group.getName();

Invio

String: il nome del 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

• setName(name)

---

isSystemGroup()

Ritiro. 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 eliminabile) o meno.

I gruppi di sistemi sono un insieme di gruppi predefiniti in Contatti Google, ad esempio "I miei contatti", "Famiglia", "Colleghi" e così via. Il nome di un gruppo di sistemi di solito contiene le parole "Gruppo di sistemi".

// The code below retrieves two contact groups, then logs whether or not
// each is a system group.
const myGroup = ContactsApp.getContactGroup('Work Friends');
const systemGroup = ContactsApp.getContactGroup('System Group: Coworkers');
Logger.log(myGroup.isSystemGroup());      // Returns false, if the group exists.
Logger.log(systemGroup.isSystemGroup());  // Returns true.

Invio

Boolean: indica se questo gruppo di contatti è un gruppo di sistema

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)

Ritiro. 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
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  group.removeContact(contacts[i]);
}

Parametri

Nome	Tipo	Descrizione
contact	Contact	Il contatto da rimuovere dal gruppo

Invio

ContactGroup: 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

• addContact(contact)

---

setGroupName(name)

Ritiro. 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)

Ritiro. 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"
const group = ContactsApp.getContactGroup('Work Friends');
group.setName('Work Buddies');

Parametri

Nome	Tipo	Descrizione
name	String	Il nuovo nome del gruppo di contatti

Invio

ContactGroup: 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

• getName()