Questa pagina è stata tradotta dall'API Cloud Translation.

Class ContactGroup

Obsoleta. Utilizza invece il servizio avanzato API People

Un gruppo di contatti è un gruppo di contatti.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
`addContact(contact)`	`ContactGroup`	Aggiunge il contatto specificato a questo gruppo
`deleteGroup()`	`void`	Elimina questo gruppo di contatti.
`getContacts()`	`Contact[]`	Recupera tutti i contatti in questo gruppo di contatti.
`getGroupName()`	`String`	Restituisce il nome di questo gruppo.
`getId()`	`String`	Ottieni l'ID di questo gruppo di contatti.
`getName()`	`String`	Consente di acquisire 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 selezionabile) o meno.
`removeContact(contact)`	`ContactGroup`	Rimuove il contatto specificato da questo gruppo
`setGroupName(name)`	`void`	Imposta il nome di questo gruppo.
`setName(name)`	`ContactGroup`	Imposta il nome di questo gruppo di contatti.

Metodi deprecati

`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`	`Contact`	il contatto da aggiungere al gruppo

Ritorni

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

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

isSystemGroup()

`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

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

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

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

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

setName(name)

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

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`	`Contact`	il contatto da rimuovere dal gruppo

Ritorni

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

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

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

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