Class ContactGroup

Gruppodi contatto

Ritiro. Utilizza invece il servizio avanzato dell'API People

Un ContactGroup è un gruppo di contatti.

MetodoTipo restituitoBreve descrizione
addContact(contact)ContactGroupAggiunge 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',
    'john.doe@example.com',
);
const group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);
deleteGroup()voidConsente di eliminare questo gruppo di contatti.
getContacts()Contact[]Recupera tutti i contatti di questo gruppo di contatti.
getGroupName()StringRestituisce il nome di questo gruppo.
getId()StringRecupera l'ID di questo gruppo di contatti.
getName()StringRestituisce il nome di questo gruppo di contatti.
isSystemGroup()BooleanRestituisce un valore booleano per determinare se questo gruppo di contatti è un gruppo di sistema (non eliminabile) o meno.
removeContact(contact)ContactGroupRimuove 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)voidImposta il nome di questo gruppo.
setName(name)ContactGroupImposta il nome di questo gruppo di contatti.

Metodi ritirati

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',
    'john.doe@example.com',
);
const group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);

Parametri

NomeTipoDescrizione
contactContactIl 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

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

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

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

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

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

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

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

NomeTipoDescrizione
contactContactIl 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

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

Imposta il nome di questo gruppo.

Parametri

NomeTipoDescrizione
nameStringil 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

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

NomeTipoDescrizione
nameStringIl 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