Class Contact

Contatto

Obsoleta. Utilizza invece il servizio avanzato API People

Un contatto contiene il nome, l'indirizzo e vari dati di contatto di un contatto.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
addAddress(label, address)	AddressField	Aggiunge un indirizzo al contatto con un'etichetta standard o personalizzata.
addCompany(company, title)	CompanyField	Aggiunge un'azienda al contatto.
addCustomField(label, content)	CustomField	Aggiunge un campo personalizzato al contatto con un'etichetta estesa o personalizzata.
addDate(label, month, day, year)	DateField	Aggiunge una data al contatto con un'etichetta standard o personalizzata.
addEmail(label, address)	EmailField	Aggiungi un indirizzo email con un'etichetta standard (casa, lavoro ecc.) o un'etichetta personalizzata
addIM(label, address)	IMField	Aggiunge un indirizzo IM al contatto con un'etichetta standard o personalizzata.
addPhone(label, number)	PhoneField	Aggiunge al contatto un numero di telefono con un'etichetta standard o personalizzata.
addToGroup(group)	Contact	Aggiunge questo contatto al gruppo di contatti specificato.
addUrl(label, url)	UrlField	Aggiunge un URL al contatto con un'etichetta standard o personalizzata.
deleteContact()	void	Elimina questo contatto.
getAddresses()	AddressField[]	Recupera tutti gli indirizzi di questo contatto.
getAddresses(label)	AddressField[]	Restituisce tutti gli indirizzi di questo contatto corrispondenti a un campo specifico.
getCompanies()	CompanyField[]	Consente di acquisire tutte le aziende per questo contatto.
getContactGroups()	ContactGroup[]	Restituisce tutti i gruppi di contatti che contengono il contatto.
getCustomFields()	CustomField[]	Recupera tutti i campi personalizzati per questo contatto.
getCustomFields(label)	CustomField[]	Restituisce tutti i campi personalizzati per questo contatto corrispondenti a un campo specifico.
getDates()	DateField[]	Recupera tutte le date per questo contatto.
getDates(label)	DateField[]	Restituisce tutte le date per questo contatto corrispondenti a un campo specifico.
getEmailAddresses()	String[]	Ottieni un elenco degli indirizzi email disponibili per questo contatto.
getEmails()	EmailField[]	Recupera gli indirizzi email di questo contatto.
getEmails(label)	EmailField[]	Restituisce gli indirizzi email per questo contatto corrispondenti a un campo specifico.
getFamilyName()	String	Restituisce il nome della famiglia (cognome) del contatto come stringa.
getFullName()	String	Restituisce il nome completo (nome e cognome) del contatto come stringa.
getGivenName()	String	Restituisce il nome specificato (nome) del contatto come stringa.
getHomeAddress()	String	Restituisce l'indirizzo di casa di questo contatto o una stringa vuota se non ne esiste nessuno.
getHomeFax()	String	Restituisce il numero di fax di casa di questo contatto o la stringa vuota se non esiste.
getHomePhone()	String	Restituisce il numero di telefono di casa di questo contatto o la stringa vuota se non esiste.
getIMs()	IMField[]	Recupera tutti gli indirizzi IM di questo contatto.
getIMs(label)	IMField[]	Restituisce tutti gli indirizzi IM per questo contatto che corrispondono a un campo specifico.
getId()	String	Restituisce l'ID univoco del contatto.
getInitials()	String	Recupera le iniziali del contatto.
getLastUpdated()	Date	Visualizza la data dell'ultimo aggiornamento di questo contatto.
getMaidenName()	String	Restituisce il nome da nubile del contatto come stringa.
getMiddleName()	String	Restituisce il secondo nome del contatto come stringa.
getMobilePhone()	String	Restituisce il numero di cellulare di questo contatto o la stringa vuota se non esiste.
getNickname()	String	Restituisce il nickname del contatto come stringa.
getNotes()	String	Restituisce le note associate al contatto o una stringa vuota se non ci sono note.
getPager()	String	Restituisce il numero di telefono del cercapersone di questo contatto o una stringa vuota se non ne esiste nessuno.
getPhones()	PhoneField[]	Recupera tutti i numeri di telefono di questo contatto.
getPhones(label)	PhoneField[]	Restituisce tutti i numeri di telefono per questo contatto corrispondenti a un campo specifico.
getPrefix()	String	Restituisce il prefisso del nome del contatto.
getPrimaryEmail()	String	Restituisce l'indirizzo email principale del contatto sotto forma di stringa.
getShortName()	String	Restituisce il nome breve del contatto come stringa.
getSuffix()	String	Restituisce il suffisso sul nome del contatto.
getUrls()	UrlField[]	Recupera tutti gli URL per questo contatto.
getUrls(label)	UrlField[]	Restituisce tutti gli URL per questo contatto corrispondenti a un campo specifico.
getUserDefinedField(key)	String	Restituisce il valore definito dall'utente associato alla chiave specificata.
getUserDefinedFields()	Object	Restituisce tutti i campi definiti dall'utente per questo contatto e li restituisce come proprietà di un oggetto JavaScript.
getWorkAddress()	String	Restituisce l'indirizzo di lavoro di questo contatto o una stringa vuota se non ne esiste nessuno.
getWorkFax()	String	Restituisce il numero di fax di lavoro di questo contatto o una stringa vuota se non esiste.
getWorkPhone()	String	Restituisce il numero di telefono di lavoro di questo contatto o una stringa vuota se non ne esiste nessuno.
removeFromGroup(group)	Contact	Rimuove il contatto dal gruppo di contatti specificato.
setFamilyName(familyName)	Contact	Imposta il cognome (cognome) del contatto.
setFullName(fullName)	Contact	Imposta il nome completo (nome e cognome) del contatto.
setGivenName(givenName)	Contact	Imposta il nome (nome) del contatto.
setHomeAddress(addr)	void	Imposta l'indirizzo di casa di questo contatto.
setHomeFax(phone)	void	Imposta il numero di fax di casa del contatto.
setHomePhone(phone)	void	Imposta il numero di telefono di casa per questo contatto.
setInitials(initials)	Contact	Imposta le iniziali del contatto.
setMaidenName(maidenName)	Contact	Imposta il nome da nubile del contatto.
setMiddleName(middleName)	Contact	Imposta il secondo nome del contatto.
setMobilePhone(phone)	void	Imposta il numero di cellulare di questo contatto.
setNickname(nickname)	Contact	Imposta il nickname del contatto.
setNotes(notes)	Contact	Imposta le note associate al contatto.
setPager(phone)	void	Imposta il numero del cercapersone di questo contatto.
setPrefix(prefix)	Contact	Imposta il prefisso sul nome del contatto.
setPrimaryEmail(primaryEmail)	void	Imposta l'indirizzo email principale di questo contatto.
setShortName(shortName)	Contact	Imposta il nome breve del contatto.
setSuffix(suffix)	Contact	Imposta il suffisso sul nome del contatto.
setUserDefinedField(key, value)	void	Imposta un singolo campo definito dall'utente per questo contatto, da memorizzare con una determinata chiave.
setUserDefinedFields(o)	void	Imposta i campi definiti dall'utente per il contatto con le proprietà dell'oggetto specificato.
setWorkAddress(addr)	void	Imposta l'indirizzo di lavoro di questo contatto.
setWorkFax(phone)	void	Imposta il numero di fax di lavoro del contatto.
setWorkPhone(phone)	void	Imposta il numero di telefono di lavoro di questo contatto.

Metodi deprecati

addAddress(label, address)

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

Aggiunge un indirizzo al contatto con un'etichetta standard o personalizzata.

L'etichetta può provenire da ContactsApp.Field o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the the ContactsApp.Field.WORK_ADDRESS label.
var contacts = ContactsApp.getContactsByName('John Doe');
var address = contacts[0].addAddress(ContactsApp.Field.WORK_ADDRESS,
                                    '123 Main St, Some City, NY 10011');

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta del nuovo indirizzo, da ContactsApp.Field o da una stringa personalizzata
address	String	il nuovo indirizzo

Ritorni

AddressField: il campo 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

• getAddresses()

---

addCompany(company, title)

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

Aggiunge un'azienda al contatto.

// The code below retrieves a contact named "John Doe" and adds the company "Google" and the
// job title "Product Manager".
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addCompany('Google', 'Product Manager');

Parametri

Nome	Tipo	Descrizione
company	String	il nome dell'azienda da aggiungere al contatto
title	String	la qualifica associata a questo contatto per questa azienda

Ritorni

CompanyField: il campo 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

• getCompanies()

---

addCustomField(label, content)

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

Aggiunge un campo personalizzato al contatto con un'etichetta estesa o personalizzata.

L'etichetta può provenire da ContactsApp.ExtendedField o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field named 'HOBBY'.
var contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta del nuovo indirizzo, da ContactsApp.ExtendedField o da una stringa personalizzata
content	Object	il valore da memorizzare nel campo personalizzato

Ritorni

CustomField: il campo 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

• getCustomFields()

---

addDate(label, month, day, year)

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

Aggiunge una data al contatto con un'etichetta standard o personalizzata.

L'etichetta può provenire da ContactsApp.Field o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].addDate(ContactsApp.Field.BIRTHDAY,
                                   ContactsApp.Month.APRIL, 19, 1950);

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta della nuova data, da ContactsApp.Field o da una stringa personalizzata
month	Month	il mese, da ContactApps.Month
day	Integer	il giorno
year	Integer	l'anno

Ritorni

DateField: la data di creazione

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

• getDates()

---

addEmail(label, address)

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

Aggiungi un indirizzo email con un'etichetta standard (casa, lavoro ecc.) o un'etichetta personalizzata

// The code below retrieves a contact named "John Doe" and adds the email address
// "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emailField = contacts[0].addEmail(ContactsApp.Field.HOME_EMAIL, '[e-mail]');

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta della nuova email, da ContactsApp.Field o da una stringa personalizzata
address	String	il nuovo indirizzo email

Ritorni

EmailField: il campo appena aggiunto

Autorizzazione

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

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

---

addIM(label, address)

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

Aggiunge un indirizzo IM al contatto con un'etichetta standard o personalizzata.

L'etichetta può provenire da ContactsApp.Field o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and adds the IM address "ChatWithJohn"
// with the the ContactsApp.Field.AIM label.
var contacts = ContactsApp.getContactsByName('John Doe');
var email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta del nuovo indirizzo IM, da ContactsApp.Field o da una stringa personalizzata
address	String	il nuovo indirizzo IM

Ritorni

IMField: il campo 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

• getIMs()

---

addPhone(label, number)

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

Aggiunge al contatto un numero di telefono con un'etichetta standard o personalizzata.

L'etichetta può provenire da ContactsApp.Field o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phone = contacts[0].addPhone(ContactsApp.Field.WORK_PHONE, '212-555-1234');

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta del nuovo numero di telefono, da ContactsApp.Field o da una stringa personalizzata
number	String	il nuovo numero di telefono

Ritorni

PhoneField: il campo 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

• getPhones()

---

addToGroup(group)

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

Aggiunge questo contatto al gruppo di contatti specificato.

// The code below creates a new contact and then adds it to the contact group named
// "Work Friends"
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

Parametri

Nome	Tipo	Descrizione
group	ContactGroup	il gruppo di contatti a cui aggiungere questo contatto

Ritorni

Contact - questo contatto

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

• removeFromGroup(group)

---

addUrl(label, url)

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

Aggiunge un URL al contatto con un'etichetta standard o personalizzata.

L'etichetta può provenire da ContactsApp.Field o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the the ContactsApp.Field.WORK_WEBSITE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addUrl(ContactsApp.Field.WORK_WEBSITE, 'http://www.example.com');

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta del nuovo indirizzo, da ContactsApp.Field o da una stringa personalizzata
url	String	il nuovo URL

Ritorni

UrlField: il campo 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

• getUrls()

---

deleteContact()

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

Elimina questo contatto.

var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].deleteContact();
}

Autorizzazione

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

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

---

getAddresses()

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

Recupera tutti gli indirizzi di questo contatto.

// The code below logs the addresses of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

Ritorni

AddressField[]: un elenco di indirizzi

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

• addAddress(label, address)

---

getAddresses(label)

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

Restituisce tutti gli indirizzi di questo contatto corrispondenti a un campo specifico.

L'etichetta può provenire da ContactsApp.Field o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (var i in addresses) {
  Logger.log(addresses[i].getAddress());
}

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta di corrispondenza, da ContactsApp.Field o da una stringa personalizzata

Ritorni

AddressField[]: un elenco di indirizzi

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

• addAddress(label, address)

---

getCompanies()

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

Consente di acquisire tutte le aziende per questo contatto.

// The code below logs the company names of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  var companies = contacts[i].getCompanies();
  for (var j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

Ritorni

CompanyField[]: un elenco di aziende

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

• addCompany(company, title)

---

getContactGroups()

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

Restituisce tutti i gruppi di contatti che contengono il contatto.

// The code below gets a contact named "John Doe" and retrieves all the contact groups that
// the contact belongs to
var contacts = ContactsApp.getContactsByName('John Doe');
var groups = contacts[0].getContactGroups();

Ritorni

ContactGroup[]: i gruppi contenenti questo contatto

Vedi anche

• addToGroup(group)

---

getCustomFields()

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

Recupera tutti i campi personalizzati per questo contatto.

// The code below retrieves a contact named "John Doe" and logs the custom fields
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i in fields) {
  Logger.log(fields[i].getValue());
}

Ritorni

CustomField[]: elenco di campi personalizzati

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

• addCustomField(label, content)

---

getCustomFields(label)

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

Restituisce tutti i campi personalizzati per questo contatto corrispondenti a un campo specifico.

L'etichetta può essere un'etichetta standard di ContactsApp.ExtendedField o una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and logs the custom fields
// associated with that contact that are in the ContactsApp.ExtendedField.HOBBY label.
var contacts = ContactsApp.getContactsByName('John Doe');
var hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (var i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta da abbinare, da ContactsApp.ExtendedField o da una stringa personalizzata

Ritorni

CustomField[]: elenco di campi personalizzati

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

• addCustomField(label, content)

---

getDates()

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

Recupera tutte le date per questo contatto.

// The code below retrieves a contact named "John Doe" and logs the label of the date
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var dates = contacts[0].getDates();
for (var i in dates) {
  Logger.log(dates[i].getLabel());
}

Ritorni

DateField[]: un elenco di date

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

• addDate(label, month, day, year)

---

getDates(label)

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

Restituisce tutte le date per questo contatto corrispondenti a un campo specifico.

L'etichetta può essere un'etichetta standard di ContactsApp.Field o una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and logs the day of the month
// associated with that contact that are in the ContactsApp.Field.BIRTHDAY label.
var contacts = ContactsApp.getContactsByName('John Doe');
var birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (var i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta di corrispondenza, da ContactsApp.Field o da una stringa personalizzata

Ritorni

DateField[]: un elenco di date

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

• addDate(label, month, day, year)

---

getEmailAddresses()

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

Ottieni un elenco degli indirizzi email disponibili per questo contatto.

Ritorni

String[]: un elenco di indirizzi email disponibili per questo contatto

Autorizzazione

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

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

---

getEmails()

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

Recupera gli indirizzi email di questo contatto.

// The code below retrieves a contact named "John Doe" and logs the email addresses
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails();
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

Ritorni

EmailField[]: l'elenco degli indirizzi email del contatto

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

• addEmail(label, address)

---

getEmails(label)

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

Restituisce gli indirizzi email per questo contatto corrispondenti a un campo specifico.

L'etichetta può essere un'etichetta standard di ContactsApp.Field o una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and logs the email addresses
// associated with that contact that are in the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta di corrispondenza, da ContactsApp.Field o da una stringa personalizzata

Ritorni

EmailField[]: l'elenco degli indirizzi email del contatto

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

• addEmail(label, address)

---

getFamilyName()

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

Restituisce il nome della famiglia (cognome) del contatto come stringa.

// The code below logs the family name of all the contacts whose names contain "John"
var contacts = ContactsApp.getContactsByName('John');
for (var i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

Ritorni

String: cognome del contatto

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

• setFamilyName(familyName)

---

getFullName()

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

Restituisce il nome completo (nome e cognome) del contatto come stringa.

// The code below logs the full name of all the contacts whose names contain "John"
var contacts = ContactsApp.getContactsByName('John');
for (var i in contacts) {
  Logger.log(contacts[i].getFullName());
}

Ritorni

String: nome completo del contatto

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

• setFullName(fullName)

---

getGivenName()

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

Restituisce il nome specificato (nome) del contatto come stringa.

// The code below logs the given name of all the contacts whose names contain "Smith"
var contacts = ContactsApp.getContactsByName('Smith');
for (var i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

Ritorni

String: il nome del contatto

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

• setGivenName(givenName)

---

getHomeAddress()

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

Restituisce l'indirizzo di casa di questo contatto o una stringa vuota se non ne esiste nessuno.

Ritorni

String: indirizzo di casa di questo contatto o stringa vuota se non esiste

Autorizzazione

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

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

---

getHomeFax()

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

Restituisce il numero di fax di casa di questo contatto o la stringa vuota se non esiste.

Ritorni

String: numero di fax di casa di questo contatto o stringa vuota se non esiste

Autorizzazione

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

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

---

getHomePhone()

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

Restituisce il numero di telefono di casa di questo contatto o la stringa vuota se non esiste.

Ritorni

String: numero di telefono di casa di questo contatto o stringa vuota se non esiste

Autorizzazione

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

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

---

getIMs()

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

Recupera tutti gli indirizzi IM di questo contatto.

// The code below logs the IM addresses of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getIMs());
}

Ritorni

IMField[]: un elenco di indirizzi IM

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

• addIM(label, address)

---

getIMs(label)

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

Restituisce tutti gli indirizzi IM per questo contatto che corrispondono a un campo specifico.

L'etichetta può provenire da ContactsApp.Field o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK label.
var contacts = ContactsApp.getContactsByName('John Doe');
var imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (var i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta di corrispondenza, da ContactsApp.Field o da una stringa personalizzata

Ritorni

IMField[]: un elenco di indirizzi IM

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

• addIM(label, address)

---

getId()

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

Restituisce l'ID univoco del contatto.

var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var id = contact.getId();

Ritorni

String: l'ID di questo contatto

Autorizzazione

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

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

---

getInitials()

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

Recupera le iniziali del contatto.

// The code below logs the initials of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getInitials());
}

Ritorni

String: le iniziali del contatto

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

• setInitials(initials)

---

getLastUpdated()

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

Visualizza la data dell'ultimo aggiornamento di questo contatto.

// The code below logs the last updated date of all the contacts whose names contain
// "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

Ritorni

Date: la data dell'ultimo aggiornamento del contatto

Autorizzazione

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

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

---

getMaidenName()

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

Restituisce il nome da nubile del contatto come stringa.

// The code below logs the maiden name of all the contacts whose names contain "Jane"
var contacts = ContactsApp.getContactsByName('Jane');
for (var i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

Ritorni

String: nome da nubile del contatto

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

• setMaidenName(maidenName)

---

getMiddleName()

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

Restituisce il secondo nome del contatto come stringa.

// The code below logs the middle name of all the contacts whose names contain "Smith"
var contacts = ContactsApp.getContactsByName('Smith');
for (var i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

Ritorni

String: il secondo nome del contatto

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

• setMiddleName(middleName)

---

getMobilePhone()

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

Restituisce il numero di cellulare di questo contatto o la stringa vuota se non esiste.

Ritorni

String: numero di cellulare di questo contatto o stringa vuota se non esiste

Autorizzazione

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

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

---

getNickname()

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

Restituisce il nickname del contatto come stringa.

// The code below logs the nickname of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getNickname());
}

Ritorni

String: il nickname del contatto

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

• setNickname(nickname)

---

getNotes()

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

Restituisce le note associate al contatto o una stringa vuota se non ci sono note.

// The code below logs the notes of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getNotes());
}

Ritorni

String: le note associate a questo contatto

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

• setNotes(notes)

---

getPager()

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

Restituisce il numero di telefono del cercapersone di questo contatto o una stringa vuota se non ne esiste nessuno.

Ritorni

String: il numero di telefono del cercapersone di questo contatto o la stringa vuota se non esiste

Autorizzazione

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

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

---

getPhones()

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

Recupera tutti i numeri di telefono di questo contatto.

// The code below logs the phone numbers of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPhones());
}

Ritorni

PhoneField[]: un elenco di numeri di telefono

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

• addPhone(label, number)

---

getPhones(label)

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

Restituisce tutti i numeri di telefono per questo contatto corrispondenti a un campo specifico.

L'etichetta può provenire da ContactsApp.Field o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and logs the phone numbers
// associated with that contact that are in the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (var i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta di corrispondenza, da ContactsApp.Field o da una stringa personalizzata

Ritorni

PhoneField[]: un elenco di numeri di telefono

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

• addPhone(label, number)

---

getPrefix()

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

Restituisce il prefisso del nome del contatto.

// The code below logs the prefix of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

Ritorni

String: il prefisso del nome del contatto.

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

• setPrefix(prefix)

---

getPrimaryEmail()

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

Restituisce l'indirizzo email principale del contatto sotto forma di stringa.

// The code below logs the primary email address of all the contacts whose names contain
// "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

Ritorni

String: l'indirizzo email principale del contatto.

Autorizzazione

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

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

---

getShortName()

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

Restituisce il nome breve del contatto come stringa.

// The code below logs the short name of all the contacts whose names contain "Johnathan"
var contacts = ContactsApp.getContactsByName('Johnathan');
for (var i in contacts) {
  Logger.log(contacts[i].getShortName());
}

Ritorni

String: il nome breve del contatto

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

• setShortName(shortName)

---

getSuffix()

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

Restituisce il suffisso sul nome del contatto.

// The code below logs the suffix of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

Ritorni

String: il suffisso del nome del contatto

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

• setSuffix(suffix)

---

getUrls()

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

Recupera tutti gli URL per questo contatto.

// The code below logs the URLs of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getUrls());
}

Ritorni

UrlField[]: un elenco di URL

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

• addUrl(label, url)

---

getUrls(label)

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

Restituisce tutti gli URL per questo contatto corrispondenti a un campo specifico.

L'etichetta può provenire da ContactsApp.Field o da una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (var i in urls) {
  Logger.log(urls[i].getAddress());
}

Parametri

Nome	Tipo	Descrizione
label	Object	l'etichetta di corrispondenza, da ContactsApp.Field o da una stringa personalizzata

Ritorni

UrlField[]: un elenco di URL

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

• addUrl(label, url)

---

getUserDefinedField(key)

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

Restituisce il valore definito dall'utente associato alla chiave specificata.

Parametri

Nome	Tipo	Descrizione
key	String	la chiave può essere di qualsiasi tipo di base (stringa, int, ecc.)

Ritorni

String: i contenuti definiti dall'utente che sono stati archiviati con questa chiave

Autorizzazione

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

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

---

getUserDefinedFields()

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

Restituisce tutti i campi definiti dall'utente per questo contatto e li restituisce come proprietà di un oggetto JavaScript.

Ritorni

Object: i campi definiti dall'utente per questo contatto, come proprietà di un oggetto JavaScript

Autorizzazione

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

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

---

getWorkAddress()

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

Restituisce l'indirizzo di lavoro di questo contatto o una stringa vuota se non ne esiste nessuno.

Ritorni

String: l'indirizzo di lavoro di questo contatto o stringa vuota se non ne esiste nessuno

Autorizzazione

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

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

---

getWorkFax()

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

Restituisce il numero di fax di lavoro di questo contatto o una stringa vuota se non esiste.

Ritorni

String: numero di fax di lavoro di questo contatto o stringa vuota se non esiste

Autorizzazione

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

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

---

getWorkPhone()

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

Restituisce il numero di telefono di lavoro di questo contatto o una stringa vuota se non ne esiste nessuno.

Ritorni

String: numero di telefono di lavoro di questo contatto o stringa vuota se non esiste

Autorizzazione

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

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

---

removeFromGroup(group)

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

Rimuove il contatto dal gruppo di contatti specificato.

// The code below gets all the contacts named "John Doe" and then removes each of them from
// the "Work Friends" contact group
var contacts = ContactsApp.getContactsByName('John Doe');
var group = ContactsApp.getContactGroup('Work Friends');
for (var i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

Parametri

Nome	Tipo	Descrizione
group	ContactGroup	il gruppo di contatti da cui rimuovere questo contatto

Ritorni

Contact - questo contatto

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

• addToGroup(group)

---

setFamilyName(familyName)

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

Imposta il cognome (cognome) del contatto.

// The code below changes the family name of all the contacts whose names are "John Doe"
// to "Doe-Smith"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

Parametri

Nome	Tipo	Descrizione
familyName	String	il nuovo cognome del contatto

Ritorni

Contact - questo contatto

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

• getFamilyName()

---

setFullName(fullName)

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

Imposta il nome completo (nome e cognome) del contatto.

// The code below changes the full name of all the contacts whose names are "John Doe"
// to "Johnny Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

Parametri

Nome	Tipo	Descrizione
fullName	String	Il nuovo nome completo del contatto.

Ritorni

Contact - questo contatto

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

• getFullName()

---

setGivenName(givenName)

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

Imposta il nome (nome) del contatto.

// The code below changes the given name of all the contacts whose names are "John Doe"
// to "Johnny"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setGivenName('Johnny');
}

Parametri

Nome	Tipo	Descrizione
givenName	String	il nuovo nome del contatto

Ritorni

Contact - questo contatto

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

• getGivenName()

---

setHomeAddress(addr)

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

Imposta l'indirizzo di casa di questo contatto.

Parametri

Nome	Tipo	Descrizione
addr	String	l'indirizzo di casa da impostare

Autorizzazione

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

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

---

setHomeFax(phone)

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

Imposta il numero di fax di casa del contatto.

Parametri

Nome	Tipo	Descrizione
phone	String	il numero di fax di casa da impostare

Autorizzazione

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

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

---

setHomePhone(phone)

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

Imposta il numero di telefono di casa per questo contatto.

Parametri

Nome	Tipo	Descrizione
phone	String	il numero di telefono di casa da impostare

Autorizzazione

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

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

---

setInitials(initials)

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

Imposta le iniziali del contatto.

// The code below sets the initials of all the contacts whose names are "Johnathan Doe"
// to "JD"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setInitials('JD');
}

Parametri

Nome	Tipo	Descrizione
initials	String	le nuove iniziali del contatto

Ritorni

Contact - questo contatto

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

• getInitials()

---

setMaidenName(maidenName)

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

Imposta il nome da nubile del contatto.

// The code below changes the maiden name of all the contacts whose names are "Jane Doe"
// to "Smith"
var contacts = ContactsApp.getContactsByName('Jane Doe');
for (var i in contacts) {
  contacts[i].setMaidenName('Smith');
}

Parametri

Nome	Tipo	Descrizione
maidenName	String	il nuovo nome da nubile del contatto

Ritorni

Contact - questo contatto

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

• getMaidenName()

---

setMiddleName(middleName)

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

Imposta il secondo nome del contatto.

// The code below changes the middle name of all the contacts whose names are "John Doe"
// to "Danger"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setMiddleName('Danger');
}

Parametri

Nome	Tipo	Descrizione
middleName	String	il nuovo secondo nome del contatto

Ritorni

Contact - questo contatto

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

• getMiddleName()

---

setMobilePhone(phone)

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

Imposta il numero di cellulare di questo contatto.

Parametri

Nome	Tipo	Descrizione
phone	String	il numero di cellulare da impostare

Autorizzazione

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

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

---

setNickname(nickname)

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

Imposta il nickname del contatto.

// The code below changes the nickname of all the contacts whose names are "John Doe"
// to "JohnnyD"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

Parametri

Nome	Tipo	Descrizione
nickname	String	il nuovo nickname del contatto

Ritorni

Contact - questo contatto

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

• getNickname()

---

setNotes(notes)

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

Imposta le note associate al contatto.

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

Parametri

Nome	Tipo	Descrizione
notes	String	le note da memorizzare per questo contatto

Ritorni

Contact - questo contatto

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

• getNotes()

---

setPager(phone)

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

Imposta il numero del cercapersone di questo contatto.

Parametri

Nome	Tipo	Descrizione
phone	String	il numero del cercapersone da impostare

Autorizzazione

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

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

---

setPrefix(prefix)

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

Imposta il prefisso sul nome del contatto.

// The code below sets the prefix of all the contacts whose names are "Johnathan Doe"
// to "Mr"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setPrefix('Mr');
}

Parametri

Nome	Tipo	Descrizione
prefix	String	Il nuovo prefisso del nome del contatto.

Ritorni

Contact - questo contatto

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

• getPrefix()

---

setPrimaryEmail(primaryEmail)

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

Imposta l'indirizzo email principale di questo contatto.

Parametri

Nome	Tipo	Descrizione
primaryEmail	String	l'indirizzo email principale da impostare

Autorizzazione

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

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

---

setShortName(shortName)

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

Imposta il nome breve del contatto.

// The code below changes the short name of all the contacts whose names are "Johnathan Doe"
// to "John"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setShortName('John');
}

Parametri

Nome	Tipo	Descrizione
shortName	String	Il nuovo nome breve del contatto

Ritorni

Contact - questo contatto

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

• getShortName()

---

setSuffix(suffix)

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

Imposta il suffisso sul nome del contatto.

// The code below sets the suffix of all the contacts whose names are "Johnathan Doe"
// to "Jr"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setSuffix('Jr');
}

Parametri

Nome	Tipo	Descrizione
suffix	String	Il nuovo suffisso del nome del contatto

Ritorni

Contact - questo contatto

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

• getSuffix()

---

setUserDefinedField(key, value)

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

Imposta un singolo campo definito dall'utente per questo contatto, da memorizzare con una determinata chiave.

Parametri

Nome	Tipo	Descrizione
key	String	la chiave può essere di qualsiasi tipo di base (stringa, int, ecc.)
value	String	il valore può essere qualsiasi tipo di base (stringa, int e così via)

Autorizzazione

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

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

---

setUserDefinedFields(o)

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

Imposta i campi definiti dall'utente per il contatto con le proprietà dell'oggetto specificato.

Parametri

Nome	Tipo	Descrizione
o	Object	un oggetto con una o più proprietà nel formato {key: value}

Autorizzazione

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

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

---

setWorkAddress(addr)

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

Imposta l'indirizzo di lavoro di questo contatto.

Parametri

Nome	Tipo	Descrizione
addr	String	l'indirizzo di lavoro da impostare

Autorizzazione

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

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

---

setWorkFax(phone)

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

Imposta il numero di fax di lavoro del contatto.

Parametri

Nome	Tipo	Descrizione
phone	String	il numero di fax di lavoro da impostare

Autorizzazione

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

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

---

setWorkPhone(phone)

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

Imposta il numero di telefono di lavoro di questo contatto.

Parametri

Nome	Tipo	Descrizione
phone	String	il numero di telefono di lavoro da impostare

Autorizzazione

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

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