Class ContactsApp

App Contatti

Ritiro. Utilizza invece il servizio avanzato dell'API People

Questa classe consente agli utenti di accedere ai propri Contatti Google e di creare, rimuovere e aggiornare i contatti elencati al loro interno.

Proprietà ritirate

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

Metodi ritirati

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 // The code below creates a new contact group named "Work Friends" const group = ContactsApp.createContactGroup('Work Friends');
deleteContact(contact)	void	Elimina il contatto.
deleteContactGroup(group)	void	Elimina il gruppo di contatti // The code below creates deletes the contact group named "Work Friends" const group = ContactsApp.getContactGroup('Work Friends'); ContactsApp.deleteContactGroup(group);
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	Recupera un gruppo di contatti con il nome specificato o restituisce null se non viene trovato alcun gruppo di contatti con questo nome.
getContactGroupById(id)	ContactGroup	Recupera un gruppo di contatti con l'ID specificato o restituisce null se non viene trovato alcun gruppo di contatti.
getContactGroups()	ContactGroup[]	Recupera l'elenco completo dei gruppi di contatti dell'utente.
getContacts()	Contact[]	Recupera tutti i contatti dell'utente.
getContactsByAddress(query)	Contact[]	Trova i contatti corrispondenti a un indirizzo.
getContactsByAddress(query, label)	Contact[]	Recupera i contatti corrispondenti a un indirizzo, limitati a un campo specifico.
getContactsByAddress(query, label)	Contact[]	Recupera i contatti corrispondenti a un indirizzo, limitati all'etichetta dell'indirizzo personalizzato specificata.
getContactsByCompany(query)	Contact[]	Visualizza i contatti corrispondenti al campo dell'azienda.
getContactsByCustomField(query, label)	Contact[]	Recupera i contatti corrispondenti a un determinato valore in un campo personalizzato.
getContactsByDate(month, day, label)	Contact[]	Recupera i contatti corrispondenti a un determinato mese e giorno per un determinato campo standard.
getContactsByDate(month, day, year, label)	Contact[]	Recupera i contatti corrispondenti a un determinato mese, giorno e anno per un determinato campo standard.
getContactsByDate(month, day, year, label)	Contact[]	Recupera i contatti corrispondenti a un determinato mese, giorno e anno per un determinato campo personalizzato.
getContactsByDate(month, day, label)	Contact[]	Recupera i contatti corrispondenti a un determinato mese e giorno per un determinato campo personalizzato.
getContactsByEmailAddress(query)	Contact[]	Trova i contatti corrispondenti a un indirizzo email.
getContactsByEmailAddress(query, label)	Contact[]	Recupera 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 specificato.
getContactsByGroup(group)	Contact[]	Recupera i contatti in un determinato gruppo di contatti.
getContactsByIM(query)	Contact[]	Trova i contatti corrispondenti a un indirizzo di messaggistica istantanea.
getContactsByIM(query, label)	Contact[]	Recupera i contatti corrispondenti a un indirizzo di messaggistica istantanea, limitato a un campo specifico.
getContactsByIM(query, label)	Contact[]	Recupera i contatti corrispondenti a un indirizzo di messaggistica istantanea, limitato all'etichetta di messaggistica istantanea personalizzata specificata.
getContactsByJobTitle(query)	Contact[]	Visualizza i contatti corrispondenti al campo della qualifica.
getContactsByName(query)	Contact[]	Trovare i contatti corrispondenti a un nome.
getContactsByName(query, label)	Contact[]	Recupera i contatti corrispondenti a un nome, limitati a un campo specifico.
getContactsByNotes(query)	Contact[]	Recupera i contatti corrispondenti al campo Note.
getContactsByPhone(query)	Contact[]	Visualizza i contatti corrispondenti a un numero di telefono.
getContactsByPhone(query, label)	Contact[]	Recupera i contatti corrispondenti a un numero di telefono, limitati a un campo specifico.
getContactsByPhone(query, label)	Contact[]	Recupera i contatti corrispondenti a un numero di telefono, limitatamente all'etichetta del numero di telefono personalizzato 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 ritirati

createContact(givenName, familyName, email)

Ritiro. 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]".
const 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

Invio

Contact: l'oggetto Contact 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)

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

Parametri

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

Invio

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)

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

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

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

Invio

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

---

findContactGroup(name)

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

Invio

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

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

Recupera tutti i contatti appartenenti a questo utente.

Invio

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)

Ritiro. 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 ha contrassegnato l'indirizzo email come principale o se più contatti hanno contrassegnato l'indirizzo email come principale, viene restituito il primo risultato nell'ordine dei contatti ordinati.

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

Parametri

Nome	Tipo	Descrizione
emailAddress	String	L'indirizzo email del contatto

Invio

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)

Ritiro. 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"
const id =
    'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
const contact = ContactsApp.getContactById(id);

Parametri

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

Invio

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)

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

Recupera un gruppo di contatti con il nome specificato o restituisce null se non viene trovato alcun gruppo di contatti con questo nome.

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

Parametri

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

Invio

ContactGroup: il gruppo di contatti corrispondente o null 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)

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

Recupera un gruppo di contatti con l'ID specificato o restituisce null se non viene trovato alcun gruppo di contatti.

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

Parametri

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

Invio

ContactGroup: il gruppo di contatti corrispondente o null se non viene trovato alcun gruppo di contatti corrispondente

Vedi anche

• getContactGroups()

---

getContactGroups()

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

Recupera 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.
const groups = ContactsApp.getContactGroups();
for (let i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

Invio

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

Ritiro. 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
const contacts = ContactsApp.getContacts();

Invio

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)

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

Trova i contatti corrispondenti a un indirizzo.

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

Parametri

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

Invio

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)

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

Recupera 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.
const 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	Il campo in cui eseguire la ricerca

Invio

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)

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

Recupera i contatti corrispondenti a un indirizzo, limitati all'etichetta dell'indirizzo personalizzato 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".
const contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi dei contatti con l'etichetta dell'indirizzo personalizzato specificata
label	String	l'etichetta dell'indirizzo personalizzato in cui effettuare la ricerca

Invio

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)

Ritiro. 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".
const contacts = ContactsApp.getContactsByCompany('Google');

Parametri

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

Invio

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)

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

Recupera i contatti corrispondenti a un determinato valore in un campo personalizzato.

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

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
const 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

Invio

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)

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

Recupera i contatti corrispondenti a un determinato mese e giorno 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    ContactsApp.Field.BIRTHDAY,
);

Parametri

Nome	Tipo	Descrizione
month	Month	il mese da associare, come uno dei valori di ContactsApp.Month
day	Integer	il giorno della partita
label	Field	Il campo in cui eseguire la ricerca, da ContactsApp.Field

Invio

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)

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

Recupera i contatti corrispondenti a un determinato mese, giorno e anno 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    1950,
    ContactsApp.Field.BIRTHDAY,
);

Parametri

Nome	Tipo	Descrizione
month	Month	il mese da associare, come uno dei valori di ContactsApp.Month
day	Integer	il giorno della partita
year	Integer	l'anno da associare, può essere null
label	Field	Il campo in cui eseguire la ricerca, da ContactsApp.Field

Invio

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)

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

Recupera i contatti corrispondenti a un determinato mese, giorno e anno 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    2011,
    'Start Date',
);

Parametri

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

Invio

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)

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

Recupera i contatti corrispondenti a un determinato mese e giorno 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    'Start Date',
);

Parametri

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

Invio

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)

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

Trova i contatti corrispondenti a un indirizzo email.

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

Parametri

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

Invio

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)

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

Recupera 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.
const contacts = ContactsApp.getContactsByEmailAddress(
    '[e-mail]',
    ContactsApp.Field.HOME_EMAIL,
);

Parametri

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

Invio

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)

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

// 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".
const contacts = ContactsApp.getContactsByEmailAddress(
    '[e-mail]',
    'alternate',
);

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi email dei contatti con l'etichetta dell'indirizzo email personalizzato specificata
label	String	L'etichetta dell'indirizzo email personalizzato in cui eseguire la ricerca

Invio

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)

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

Recupera i contatti in un determinato gruppo di contatti.

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

Parametri

Nome	Tipo	Descrizione
group	ContactGroup	il gruppo di contatti

Invio

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)

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

Trova i contatti corrispondenti a un indirizzo di messaggistica istantanea.

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

Parametri

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

Invio

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)

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

Recupera i contatti corrispondenti a un indirizzo di messaggistica istantanea, limitato 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.
const contacts = ContactsApp.getContactsByIM(
    'ChatWithJohnDoe',
    ContactsApp.Field.AIM,
);

Parametri

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

Invio

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)

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

Recupera i contatti corrispondenti a un indirizzo di messaggistica istantanea, limitato all'etichetta di messaggistica istantanea 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".
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

Parametri

Nome	Tipo	Descrizione
query	String	la stringa da cercare negli indirizzi di messaggistica istantanea del contatto con l'etichetta di messaggistica istantanea personalizzata specificata
label	String	l'etichetta della messaggistica istantanea personalizzata in cui eseguire la ricerca

Invio

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)

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

Visualizza i contatti corrispondenti al campo della qualifica.

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

Parametri

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

Invio

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)

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

Trovare i contatti corrispondenti a un nome.

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

Parametri

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

Invio

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)

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

Recupera 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.
const contacts = ContactsApp.getContactsByName(
    'John',
    ContactsApp.Field.GIVEN_NAME,
);

Parametri

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

Invio

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)

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

Recupera i contatti corrispondenti al campo Note.

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

Parametri

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

Invio

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)

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

Visualizza i contatti corrispondenti a un numero di telefono.

Questo metodo espande i numeri di telefono con lettere, quindi se cerchi "212-555-CODICE" e hai "212-555-2633" nei tuoi contatti 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.
const contacts = ContactsApp.getContactsByPhone('212-555-1234');

Parametri

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

Invio

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)

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

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

Questo metodo espande i numeri di telefono con lettere, quindi se cerchi "212-555-CODICE" e hai "212-555-2633" nei tuoi contatti 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.
const 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	Il campo in cui eseguire la ricerca

Invio

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)

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

Recupera i contatti corrispondenti a un numero di telefono, limitatamente all'etichetta del numero di telefono personalizzato specificata.

Questo metodo espande i numeri di telefono con lettere, quindi se cerchi "212-555-CODICE" e hai "212-555-2633" nei tuoi contatti 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".
const 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 in cui eseguire la ricerca

Invio

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)

Ritiro. 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.
const contacts = ContactsApp.getContactsByUrl('www.example.com');

Parametri

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

Invio

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)

Ritiro. 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.
const 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	Il campo in cui eseguire la ricerca

Invio

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)

Ritiro. 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".
const 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 in cui eseguire la ricerca

Invio

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)