Class ContactsApp

ContactsApp

Obsoleta. Utilizza invece il servizio avanzato API People

Questo corso consente agli utenti di accedere ai propri Contatti Google e di creare, rimuovere e aggiornare i contatti elencati al suo interno.

Proprietà deprecate

Proprietà	Tipo	Descrizione
ExtendedField	ExtendedField
Field	Field
Gender	Gender
Month	Month
Priority	Priority
Sensitivity	Sensitivity

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
createContact(givenName, familyName, email)	Contact	Crea un nuovo contatto.
createContactGroup(name)	ContactGroup	Crea un gruppo di contatti con il nome specificato
deleteContact(contact)	void	Elimina il contatto.
deleteContactGroup(group)	void	Elimina il gruppo di contatti
findByEmailAddress(email)	Contact	Trova un contatto con l'indirizzo email specificato.
findContactGroup(name)	ContactGroup	Trova un gruppo di contatti con il nome specificato.
getAllContacts()	Contact[]	Recupera tutti i contatti appartenenti a questo utente.
getContact(emailAddress)	Contact	Recupera un contatto tramite l'indirizzo email.
getContactById(id)	Contact	Recupera il contatto con questo ID.
getContactGroup(name)	ContactGroup	Restituisce un gruppo di contatti con il nome specificato o restituisce null se tale gruppo di contatti non viene trovato.
getContactGroupById(id)	ContactGroup	Restituisce un gruppo di contatti con l'ID specificato oppure restituisce null se tale gruppo di contatti non viene trovato.
getContactGroups()	ContactGroup[]	Restituisce l'elenco completo dei gruppi di contatti dell'utente.
getContacts()	Contact[]	Recupera tutti i contatti dell'utente.
getContactsByAddress(query)	Contact[]	Trovare i contatti che corrispondono a un indirizzo.
getContactsByAddress(query, label)	Contact[]	Visualizza i contatti corrispondenti a un indirizzo, limitati a un campo specifico.
getContactsByAddress(query, label)	Contact[]	Visualizza i contatti corrispondenti a un indirizzo, limitati all'etichetta dell'indirizzo personalizzata specificata.
getContactsByCompany(query)	Contact[]	Visualizza i contatti corrispondenti al campo dell'azienda.
getContactsByCustomField(query, label)	Contact[]	Recupera i contatti che corrispondono a un determinato valore in un campo personalizzato.
getContactsByDate(month, day, label)	Contact[]	Visualizza i contatti corrispondenti a un mese e un giorno specifici per un determinato campo standard.
getContactsByDate(month, day, year, label)	Contact[]	Visualizza i contatti corrispondenti a un mese, un giorno e un anno specifici per un determinato campo standard.
getContactsByDate(month, day, year, label)	Contact[]	Visualizza i contatti corrispondenti a un mese, un giorno e un anno specifici per un determinato campo personalizzato.
getContactsByDate(month, day, label)	Contact[]	Visualizza i contatti corrispondenti a un mese e un giorno specifici per un determinato campo personalizzato.
getContactsByEmailAddress(query)	Contact[]	Visualizzare i contatti corrispondenti a un indirizzo email.
getContactsByEmailAddress(query, label)	Contact[]	Visualizza i contatti corrispondenti a un indirizzo email, limitati a un campo specifico.
getContactsByEmailAddress(query, label)	Contact[]	Recupera i contatti corrispondenti a un indirizzo email, limitati all'etichetta dell'indirizzo email personalizzato specificata.
getContactsByGroup(group)	Contact[]	Recuperare i contatti in un determinato gruppo di contatti.
getContactsByIM(query)	Contact[]	Trova contatti corrispondenti a un indirizzo di messaggistica immediata.
getContactsByIM(query, label)	Contact[]	Visualizza i contatti corrispondenti a un indirizzo di messaggistica immediata, limitati a un campo specifico.
getContactsByIM(query, label)	Contact[]	Recupera i contatti corrispondenti a un indirizzo di messaggistica immediata, limitati all'etichetta per la messaggistica immediata personalizzata specificata.
getContactsByJobTitle(query)	Contact[]	Trova i contatti che corrispondono al campo della qualifica.
getContactsByName(query)	Contact[]	Trova i contatti che corrispondono a un nome.
getContactsByName(query, label)	Contact[]	Visualizza i contatti corrispondenti a un nome, limitati a un campo specifico.
getContactsByNotes(query)	Contact[]	Trova i contatti corrispondenti al campo delle note.
getContactsByPhone(query)	Contact[]	Visualizza i contatti corrispondenti a un numero di telefono.
getContactsByPhone(query, label)	Contact[]	Visualizza i contatti corrispondenti a un numero di telefono, limitati a un campo specifico.
getContactsByPhone(query, label)	Contact[]	Visualizza i contatti corrispondenti a un numero di telefono, limitati all'etichetta del numero di telefono personalizzata specificata.
getContactsByUrl(query)	Contact[]	Recupera i contatti corrispondenti a un URL.
getContactsByUrl(query, label)	Contact[]	Recupera i contatti corrispondenti a un URL, limitati a un campo specifico.
getContactsByUrl(query, label)	Contact[]	Recupera i contatti corrispondenti a un URL, limitati all'etichetta dell'URL personalizzato specificata.

Metodi deprecati

createContact(givenName, familyName, email)

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

Crea un nuovo contatto.

// The code below creates a new contact with the name "John Doe" and the email address
// "[e-mail]".
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');

Parametri

Nome	Tipo	Descrizione
givenName	String	Il nome del contatto
familyName	String	il cognome del contatto
email	String	L'indirizzo email del contatto

Ritorni

Contact: l'oggetto contatto appena creato

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

• deleteContact(contact)

---

createContactGroup(name)

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

Crea un gruppo di contatti con il nome specificato

// The code below creates a new contact group named "Work Friends"
var group = ContactsApp.createContactGroup("Work Friends");

Parametri

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

Ritorni

ContactGroup: il gruppo di contatti appena creato

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

• deleteContactGroup(group)

---

deleteContact(contact)

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

Elimina il contatto.

// The code below retrieves a contact with the email address "[e-mail]"
// and then deletes that contact.
var contact = ContactsApp.getContact('[e-mail]');
ContactsApp.deleteContact(contact);

Parametri

Nome	Tipo	Descrizione
contact	Contact	il contatto da eliminare

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

• createContact(givenName, familyName, email)

---

deleteContactGroup(group)

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

Elimina il gruppo di contatti

// The code below creates deletes the contact group named "Work Friends"
var group = ContactsApp.getContactGroup("Work Friends");
ContactsApp.deleteContactGroup(group);

Parametri

Nome	Tipo	Descrizione
group	ContactGroup	il gruppo di contatti da eliminare

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

• createContactGroup(name)

---

findByEmailAddress(email)

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

Trova un contatto con l'indirizzo email specificato.

Parametri

Nome	Tipo	Descrizione
email	String	l'indirizzo email del contatto da trovare

Ritorni

Contact: il contatto contenente l'indirizzo email in questione

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://www.google.com/m8/feeds

---

findContactGroup(name)

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

Trova un gruppo di contatti con il nome specificato.

Parametri

Nome	Tipo	Descrizione
name	String	il nome del gruppo di contatti da trovare

Ritorni

ContactGroup: il gruppo di contatti corrispondente al nome specificato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://www.google.com/m8/feeds

---

getAllContacts()

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

Recupera tutti i contatti appartenenti a questo utente.

Ritorni

Contact[]: tutti i contatti di questo utente

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://www.google.com/m8/feeds

---

getContact(emailAddress)

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

Recupera un contatto tramite l'indirizzo email.

Se più contatti condividono lo stesso indirizzo email, il metodo favorisce i contatti che hanno contrassegnato l'indirizzo email come principale; se nessuno dei contatti aveva l'indirizzo email contrassegnato come principale o se più contatti avevano l'indirizzo email contrassegnato come principale, vengono restituiti i primi risultati nell'ordine dei contatti ordinato.

// The code below retrieves a contact with the email address "[e-mail]".
var contact = ContactsApp.getContact('[e-mail]');

Parametri

Nome	Tipo	Descrizione
emailAddress	String	L'indirizzo email del contatto

Ritorni

Contact: il contatto contenente l'indirizzo email.

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()
• getContactById(id)

---

getContactById(id)

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

Recupera il contatto con questo ID.

// The code below retrieves the contact with the id
// "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5"
var id = 'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
var contact = ContactApp.getContactById(id);

Parametri

Nome	Tipo	Descrizione
id	String	l'ID del contatto da recuperare

Ritorni

Contact: il contatto corrispondente o null

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

• getContact(emailAddress)

---

getContactGroup(name)

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

Restituisce un gruppo di contatti con il nome specificato o restituisce null se tale gruppo di contatti non viene trovato.

// The code below returns the contact group with the name "Work Friends"
var group  = ContactsApp.getContactGroup('Work Friends');

Parametri

Nome	Tipo	Descrizione
name	String	il nome del gruppo di contatti da associare

Ritorni

ContactGroup: gruppo di contatti corrispondente oppure nullo se non viene trovato alcun gruppo di contatti corrispondente

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

• getContactGroups()

---

getContactGroupById(id)

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

Restituisce un gruppo di contatti con l'ID specificato oppure restituisce null se tale gruppo di contatti non viene trovato.

// The code below returns the contact group with the id
// "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"
var id = "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb";
var group  = ContactsApp.getContactGroupById(id);

Parametri

Nome	Tipo	Descrizione
id	String	l'ID del gruppo di contatti da associare

Ritorni

ContactGroup: gruppo di contatti corrispondente oppure nullo se non viene trovato alcun gruppo di contatti corrispondente

Vedi anche

• getContactGroups()

---

getContactGroups()

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

Restituisce l'elenco completo dei gruppi di contatti dell'utente.

Un utente può avere un elenco di contatti e potenzialmente anche un elenco di gruppi di contatti. Ogni gruppo di contatti può contenere contatti. Questo metodo restituisce un elenco di tutti i gruppi di contatti.

// The retrieves all the contract groups for the user and then logs the group name of each
// contact group.
var groups  = ContactsApp.getContactGroups();
for (var i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

Ritorni

ContactGroup[]: un array dei gruppi di contatti dell'utente

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

• getContactGroup(name)

---

getContacts()

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

Recupera tutti i contatti dell'utente.

// The code below will retrieve all the user's contacts
var contacts = ContactsApp.getContacts();

Ritorni

Contact[]: un array di tutti i contatti dell'utente

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

• getContact(emailAddress)

---

getContactsByAddress(query)

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

Trovare i contatti che corrispondono a un indirizzo.

// The code below returns an array of contacts where the contact's address contains
// "San Francisco'.
var contacts = ContactsApp.getContactsByAddress('San Francisco');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi dei contatti

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByAddress(query, label)

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

Visualizza i contatti corrispondenti a un indirizzo, limitati a un campo specifico.

// The code below returns an array of contacts where the contact's address contains
// "San Francisco" in the Home address field.
var contacts = ContactsApp.getContactsByAddress('San Francisco',
                                                ContactsApp.Field.HOME_ADDRESS);

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi dei contatti
label	Field	nel campo in cui eseguire la ricerca

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByAddress(query, label)

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

Visualizza i contatti corrispondenti a un indirizzo, limitati all'etichetta dell'indirizzo personalizzata specificata.

// The code below returns an array of contacts where the contact's address contains
// "San Francisco" in a custom address label (created by the user) called
// "vacation".
var contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi dei contatti con l'etichetta indirizzo personalizzata specificata
label	String	l'etichetta indirizzo personalizzata per cercare

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByCompany(query)

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

Visualizza i contatti corrispondenti al campo dell'azienda.

// The code below returns an array of contacts where the contact's company field
// contains "Google".
var contacts = ContactsApp.getContactsByCompany('Google');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare nel campo dell'azienda del contatto

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByCustomField(query, label)

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

Recupera i contatti che corrispondono a un determinato valore in un campo personalizzato.

Il campo personalizzato può essere specificato da una stringa o come uno dei valori ContactsApp.ExtendedField.

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
var contacts = ContactsApp.getContactsByCustomField('tennis', 'Favorite Sport');

Parametri

Nome	Tipo	Descrizione
query	Object	la stringa da cercare nel campo personalizzato del contatto
label	ExtendedField	il campo personalizzato in cui eseguire la ricerca

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

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

Visualizza i contatti corrispondenti a un mese e un giorno specifici per un determinato campo standard.

// The code below returns an array of contacts where the contact's "Birthday" field
// contains April for the month and 19 for the day.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19,
                                              ContactsApp.Field.BIRTHDAY);

Parametri

Nome	Tipo	Descrizione
month	Month	il mese di riferimento, come uno dei valori di ContactsApp.Month
day	Integer	il giorno corrispondente
label	Field	il campo in cui cercare, da ContactsApp.Field

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

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

Visualizza i contatti corrispondenti a un mese, un giorno e un anno specifici per un determinato campo standard.

// The code below returns an array of contacts where the contact's "Birthday" field
// contains April for the month, 19 for the day, and 1950 for the year.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 1950,
                                             ContactsApp.Field.BIRTHDAY);

Parametri

Nome	Tipo	Descrizione
month	Month	il mese di riferimento, come uno dei valori di ContactsApp.Month
day	Integer	il giorno corrispondente
year	Integer	l'anno corrispondente, può essere null
label	Field	il campo in cui cercare, da ContactsApp.Field

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

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

Visualizza i contatti corrispondenti a un mese, un giorno e un anno specifici per un determinato campo personalizzato.

// The code below returns an array of contacts where the contact's custom "Start Date" field
// contains April for the month, 19 for the day, and 2011 for the year.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 2011, 'Start Date');

Parametri

Nome	Tipo	Descrizione
month	Month	il mese di riferimento, come uno dei valori di ContactsApp.Month
day	Integer	il giorno corrispondente
year	Integer	l'anno corrispondente, può essere null
label	String	il campo personalizzato in cui eseguire la ricerca

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

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

Visualizza i contatti corrispondenti a un mese e un giorno specifici per un determinato campo personalizzato.

// The code below returns an array of contacts where the contact's custom "Start Date" field
// contains April for the month and 19 for the day.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 'Start Date');

Parametri

Nome	Tipo	Descrizione
month	Month	il mese di riferimento, come uno dei valori di ContactsApp.Month
day	Integer	il giorno corrispondente
label	String	il campo personalizzato in cui eseguire la ricerca

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByEmailAddress(query)

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

Visualizzare i contatti corrispondenti a un indirizzo email.

// The code below returns an array of contacts where the contact's email address contains
// "[e-mail]'.
var contacts = ContactsApp.getContactsByEmailAddress('[e-mail]');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi email di contatto

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

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

Visualizza i contatti corrispondenti a un indirizzo email, limitati a un campo specifico.

// The code below returns an array of contacts where the contact's email address contains
// "[e-mail]" in the Home email field.
var contacts = ContactsApp.getContactsByEmailAddress('[e-mail]',
                                                     ContactsApp.Field.HOME_EMAIL);

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi email di contatto
label	Field	nel campo in cui eseguire la ricerca

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

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

Recupera i contatti corrispondenti a un indirizzo email, limitati all'etichetta dell'indirizzo email personalizzato specificata.

// The code below returns an array of contacts where the contact's email address contains
// "[e-mail]" in a custom email address label (created by the user) called
// "alternate".
var contacts = ContactsApp.getContactsByEmailAddress('[e-mail]', 'alternate');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi email di contatto con l'etichetta dell'indirizzo email personalizzato specificata
label	String	l'etichetta dell'indirizzo email personalizzato per cercare

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByGroup(group)

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

Recuperare i contatti in un determinato gruppo di contatti.

// The code below returns an array of contacts in the ContactGroup with the name
// "Work Friends".
var group  = ContactsApp.getContactGroup('Work Friends');
var contacts = ContactsApp.getContactsByGroup(group);

Parametri

Nome	Tipo	Descrizione
group	ContactGroup	il gruppo di contatti

Ritorni

Contact[]: un array di contatti nel gruppo specificato

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

• getContact(emailAddress)

---

getContactsByIM(query)

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

Trova contatti corrispondenti a un indirizzo di messaggistica immediata.

// The code below returns an array of contacts where the contact's instant messaging address
// contains "ChatWithJohnDoe" in any instant messaging field.
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi di messaggistica immediata del contatto

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByIM(query, label)

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

Visualizza i contatti corrispondenti a un indirizzo di messaggistica immediata, limitati a un campo specifico.

// The code below returns an array of contacts where the contact's instant messaging address
// contains "ChatWithJohnDoe" in the AIM instant messaging field.
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe',
                                            ContactsApp.Field.AIM);

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi di messaggistica immediata del contatto
label	Field	nel campo in cui eseguire la ricerca

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByIM(query, label)

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

Recupera i contatti corrispondenti a un indirizzo di messaggistica immediata, limitati all'etichetta per la messaggistica immediata personalizzata specificata.

// The code below returns an array of contacts where the contact's instant messaging address
// contains "ChatWithJohnDoe" in a custom instant messaging label (created by the user) called
// "eBuddy".
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi di messaggistica immediata del contatto con l'etichetta di messaggistica immediata personalizzata specificata
label	String	l'etichetta personalizzata della messaggistica immediata per cercare

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByJobTitle(query)

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

Trova i contatti che corrispondono al campo della qualifica.

// The code below returns an array of contacts where the contact's job title field
// contains "Product Manager".
var contacts = ContactsApp.getContactsByJobTitle('Product Manager');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare nel campo della qualifica del contatto

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByName(query)

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

Trova i contatti che corrispondono a un nome.

// The code below returns an array of contacts where the contact name contains "John"
var contacts = ContactsApp.getContactsByName('John');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare nei nomi dei contatti

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByName(query, label)

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

Visualizza i contatti corrispondenti a un nome, limitati a un campo specifico.

// The code below returns an array of contacts where the contact name contains "John"
// in the Given Name field.
var contacts = ContactsApp.getContactsByName('John', ContactsApp.Field.GIVEN_NAME);

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare nei nomi dei contatti
label	Field	nel campo in cui eseguire la ricerca

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByNotes(query)

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

Trova i contatti corrispondenti al campo delle note.

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
var contacts = ContactsApp.getContactsByNotes('sent birthday card');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare nel campo delle note del contatto

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByPhone(query)

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

Visualizza i contatti corrispondenti a un numero di telefono.

Questo metodo consente di espandere i numeri di telefono con lettere, pertanto se cerchi "212-555-CODE" e tra i contatti è presente "212-555-2633" o viceversa, il metodo troverà il contatto appropriato.

// The code below returns an array of contacts where the contact's phone number contains
// "212-555-1234' in any phone number field.
var contacts = ContactsApp.getContactsByPhone('212-555-1234');

Parametri

Nome	Tipo	Descrizione
query	String	La stringa da cercare nei numeri di telefono del contatto

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByPhone(query, label)

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

Visualizza i contatti corrispondenti a un numero di telefono, limitati a un campo specifico.

Questo metodo consente di espandere i numeri di telefono con lettere, pertanto se cerchi "212-555-CODE" e tra i contatti è presente "212-555-2633" o viceversa, il metodo troverà il contatto appropriato.

// The code below returns an array of contacts where the contact's phone number contains
// "212-555-1234" in the Home phone number field.
var contacts = ContactsApp.getContactsByPhone('212-555-1234',
                                              ContactsApp.Field.HOME_PHONE);

Parametri

Nome	Tipo	Descrizione
query	String	La stringa da cercare nei numeri di telefono del contatto
label	Field	nel campo in cui eseguire la ricerca

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByPhone(query, label)

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

Visualizza i contatti corrispondenti a un numero di telefono, limitati all'etichetta del numero di telefono personalizzata specificata.

Questo metodo consente di espandere i numeri di telefono con lettere, pertanto se cerchi "212-555-CODE" e tra i contatti è presente "212-555-2633" o viceversa, il metodo troverà il contatto appropriato.

// The code below returns an array of contacts where the contact's phone number contains
// "212-555-1234" in a custom phone number label (created by the user) called
// "alternate".
var contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

Parametri

Nome	Tipo	Descrizione
query	String	La stringa da cercare nei numeri di telefono del contatto con l'etichetta del numero di telefono personalizzata specificata
label	String	l'etichetta del numero di telefono personalizzato per cercare

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByUrl(query)

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

Recupera i contatti corrispondenti a un URL.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com' in any URL field.
var contacts = ContactsApp.getContactsByUrl('www.example.com');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli URL del contatto

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByUrl(query, label)

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

Recupera i contatti corrispondenti a un URL, limitati a un campo specifico.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in the Work URL field.
var contacts = ContactsApp.getContactsByUrl('www.example.com',
                                            ContactsApp.Field.WORK_WEBSITE);

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli URL del contatto
label	Field	nel campo in cui eseguire la ricerca

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)

---

getContactsByUrl(query, label)

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

Recupera i contatti corrispondenti a un URL, limitati all'etichetta dell'URL personalizzato specificata.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in a custom URL label (created by the user) called
// "alternate work".
var contacts = ContactsApp.getContactsByUrl('www.example.com', 'alternate work');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli URL del contatto con l'etichetta URL personalizzata specificata
label	String	l'etichetta dell'URL personalizzato per eseguire ricerche

Ritorni

Contact[]: un array di contatti corrispondenti

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

• getContact(emailAddress)