Class Contact

Contatto

Ritiro. Utilizza invece il servizio avanzato dell'API People

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

Metodi ritirati

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	Aggiungere un indirizzo email con un'etichetta standard (casa, lavoro e così via) o un'etichetta personalizzata {@code // The code below retrieves a contact named "John Doe" and adds the email // address "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
addIM(label, address)	IMField	Aggiunge un indirizzo di messaggistica istantanea al contatto con un'etichetta standard o personalizzata.
addPhone(label, number)	PhoneField	Aggiunge un numero di telefono al contatto 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[]	Recupera tutti gli indirizzi di questo contatto corrispondenti a un determinato campo.
getCompanies()	CompanyField[]	Recupera tutte le aziende per questo contatto.
getContactGroups()	ContactGroup[]	Recupera tutti i gruppi di contatti che contengono questo contatto.
getCustomFields()	CustomField[]	Recupera tutti i campi personalizzati per questo contatto.
getCustomFields(label)	CustomField[]	Recupera tutti i campi personalizzati per questo contatto corrispondenti a un determinato campo.
getDates()	DateField[]	Recupera tutte le date per questo contatto.
getDates(label)	DateField[]	Recupera tutte le date di questo contatto corrispondenti a un determinato campo.
getEmailAddresses()	String[]	Restituisce un elenco degli indirizzi email disponibili per questo contatto.
getEmails()	EmailField[]	Recupera gli indirizzi email di questo contatto.
getEmails(label)	EmailField[]	Recupera gli indirizzi email di questo contatto corrispondenti a un determinato campo.
getFamilyName()	String	Restituisce il cognome del contatto sotto forma di stringa.
getFullName()	String	Restituisce il nome completo (nome e cognome) del contatto sotto forma di stringa.
getGivenName()	String	Restituisce il nome (nome di battesimo) del contatto come stringa.
getHomeAddress()	String	Recupera l'indirizzo di casa di questo contatto o una stringa vuota se non esiste.
getHomeFax()	String	Recupera il numero di fax di casa di questo contatto o una stringa vuota se non esiste.
getHomePhone()	String	Recupera il numero di telefono di casa di questo contatto o una stringa vuota se non esiste.
getIMs()	IMField[]	Recupera tutti gli indirizzi di messaggistica istantanea per questo contatto.
getIMs(label)	IMField[]	Recupera tutti gli indirizzi di messaggistica istantanea per questo contatto corrispondenti a un determinato campo.
getId()	String	Restituisce l'ID univoco di questo contatto.
getInitials()	String	Recupera le iniziali del contatto.
getLastUpdated()	Date	Restituisce la data dell'ultimo aggiornamento del contatto.
getMaidenName()	String	Restituisce il cognome da nubile del contatto sotto forma di stringa.
getMiddleName()	String	Restituisce il secondo nome del contatto sotto forma di stringa.
getMobilePhone()	String	Recupera il numero di cellulare di questo contatto o una stringa vuota se non esiste.
getNickname()	String	Restituisce il nickname del contatto come stringa.
getNotes()	String	Recupera le note associate a questo contatto o una stringa vuota se non sono presenti note.
getPager()	String	Recupera il numero di telefono del pager di questo contatto o una stringa vuota se non esiste.
getPhones()	PhoneField[]	Recupera tutti i numeri di telefono di questo contatto.
getPhones(label)	PhoneField[]	Recupera tutti i numeri di telefono di questo contatto corrispondenti a un determinato campo.
getPrefix()	String	Recupera 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 sotto forma di stringa.
getSuffix()	String	Recupera il suffisso del nome del contatto.
getUrls()	UrlField[]	Recupera tutti gli URL per questo contatto.
getUrls(label)	UrlField[]	Recupera tutti gli URL di questo contatto corrispondenti a un determinato campo.
getUserDefinedField(key)	String	Recupera il valore definito dall'utente associato alla chiave specificata.
getUserDefinedFields()	Object	Recupera tutti i campi definiti dall'utente per questo contatto e li restituisce come proprietà di un oggetto JavaScript.
getWorkAddress()	String	Recupera l'indirizzo di lavoro di questo contatto o una stringa vuota se non esiste.
getWorkFax()	String	Recupera il numero di fax di lavoro di questo contatto o una stringa vuota se non esiste.
getWorkPhone()	String	Recupera il numero di telefono di lavoro di questo contatto o una stringa vuota se non esiste.
removeFromGroup(group)	Contact	Rimuove questo contatto dal gruppo di contatti specificato.
setFamilyName(familyName)	Contact	Imposta il 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 di questo contatto.
setHomePhone(phone)	void	Imposta il numero di telefono di casa di 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 a questo contatto.
setPager(phone)	void	Imposta il numero del pager 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 al 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 questo 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 di questo contatto.
setWorkPhone(phone)	void	Imposta il numero di telefono di lavoro di questo contatto.

Metodi ritirati

addAddress(label, address)

Ritiro. 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ò essere di ContactsApp.Field o 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 ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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

Invio

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)

Ritiro. 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".
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addCompany('Google', 'Product Manager');

Parametri

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

Invio

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)

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

Invio

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)

Ritiro. 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ò essere di ContactsApp.Field o 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".
const contacts = ContactsApp.getContactsByName('John Doe');
const 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

Invio

DateField: la data di creazione del nuovo account

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)

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

Aggiungere un indirizzo email con un'etichetta standard (casa, lavoro e così via) 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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

Invio

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)

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

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

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

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

Parametri

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

Invio

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)

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

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

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

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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

Invio

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)

Ritiro. 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"
let contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
const group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

Parametri

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

Invio

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)

Ritiro. 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ò essere di ContactsApp.Field o una stringa di etichetta personalizzata.

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the ContactsApp.Field.WORK_WEBSITE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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

Invio

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

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

Elimina questo contatto.

const contacts = ContactsApp.getContactsByName('John Doe');
for (const 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()

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

Invio

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)

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

Recupera tutti gli indirizzi di questo contatto corrispondenti a un determinato campo.

L'etichetta può essere di ContactsApp.Field o 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (const i in addresses) {
  Logger.log(addresses[i].getAddress());
}

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta da associare, da ContactsApp.Field o da una stringa personalizzata

Invio

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

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

Recupera tutte le aziende per questo contatto.

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

Invio

CompanyField[]: un elenco di società

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

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

Recupera tutti i gruppi di contatti che contengono questo contatto.

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

Invio

ContactGroup[]: i gruppi contenenti questo contatto

Vedi anche

• addToGroup(group)

---

getCustomFields()

Ritiro. 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
const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (const i in fields) {
  Logger.log(fields[i].getValue());
}

Invio

CustomField[]: un 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)

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

Recupera tutti i campi personalizzati per questo contatto corrispondenti a un determinato campo.

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.
const contacts = ContactsApp.getContactsByName('John Doe');
const hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (const i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

Parametri

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

Invio

CustomField[]: un 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()

Ritiro. 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
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (const i in dates) {
  Logger.log(dates[i].getLabel());
}

Invio

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)

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

Recupera tutte le date di questo contatto corrispondenti a un determinato campo.

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.
const contacts = ContactsApp.getContactsByName('John Doe');
const birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (const i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta da associare, da ContactsApp.Field o da una stringa personalizzata

Invio

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

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

Restituisce un elenco degli indirizzi email disponibili per questo contatto.

Invio

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

Ritiro. 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
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails();
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

Invio

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)

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

Recupera gli indirizzi email di questo contatto corrispondenti a un determinato campo.

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.
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta da associare, da ContactsApp.Field o da una stringa personalizzata

Invio

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

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

Restituisce il cognome del contatto sotto forma di stringa.

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

Invio

String: il 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()

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

Restituisce il nome completo (nome e cognome) del contatto sotto forma di stringa.

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

Invio

String: il 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()

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

Restituisce il nome (nome di battesimo) del contatto come stringa.

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

Invio

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

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

Recupera l'indirizzo di casa di questo contatto o una stringa vuota se non esiste.

Invio

String: l'indirizzo di casa di questo contatto o una 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()

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

Recupera il numero di fax di casa di questo contatto o una stringa vuota se non esiste.

Invio

String: il numero di fax di casa di questo contatto o una 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()

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

Recupera il numero di telefono di casa di questo contatto o una stringa vuota se non esiste.

Invio

String: il numero di telefono di casa di questo contatto o una 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()

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

Recupera tutti gli indirizzi di messaggistica istantanea per questo contatto.

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

Invio

IMField[]: un elenco di indirizzi di messaggistica istantanea

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)

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

Recupera tutti gli indirizzi di messaggistica istantanea per questo contatto corrispondenti a un determinato campo.

L'etichetta può essere di ContactsApp.Field o 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (const i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta da associare, da ContactsApp.Field o da una stringa personalizzata

Invio

IMField[]: un elenco di indirizzi di messaggistica istantanea

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

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

Restituisce l'ID univoco di questo contatto.

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

Invio

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

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getInitials());
}

Invio

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

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

Restituisce la data dell'ultimo aggiornamento del contatto.

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

Invio

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

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

Restituisce il cognome da nubile del contatto sotto forma di stringa.

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

Invio

String: il cognome 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()

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

Restituisce il secondo nome del contatto sotto forma di stringa.

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

Invio

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

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

Recupera il numero di cellulare di questo contatto o una stringa vuota se non esiste.

Invio

String: il numero di cellulare di questo contatto o una 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()

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNickname());
}

Invio

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

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

Recupera le note associate a questo contatto o una stringa vuota se non sono presenti note.

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

Invio

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

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

Recupera il numero di telefono del pager di questo contatto o una stringa vuota se non esiste.

Invio

String: il numero di telefono del pager di questo contatto o una 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()

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPhones());
}

Invio

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)

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

Recupera tutti i numeri di telefono di questo contatto corrispondenti a un determinato campo.

L'etichetta può essere di ContactsApp.Field o 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (const i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta da associare, da ContactsApp.Field o da una stringa personalizzata

Invio

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

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

Recupera il prefisso del nome del contatto.

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

Invio

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

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

Invio

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

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

Restituisce il nome breve del contatto sotto forma di stringa.

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

Invio

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

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

Recupera il suffisso del nome del contatto.

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

Invio

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

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getUrls());
}

Invio

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)

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

Recupera tutti gli URL di questo contatto corrispondenti a un determinato campo.

L'etichetta può essere di ContactsApp.Field o 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (const i in urls) {
  Logger.log(urls[i].getAddress());
}

Parametri

Nome	Tipo	Descrizione
label	Object	L'etichetta da associare, da ContactsApp.Field o da una stringa personalizzata

Invio

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)

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

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

Parametri

Nome	Tipo	Descrizione
key	String	la chiave può essere di qualsiasi tipo di base (String, int e così via)

Invio

String: i contenuti definiti dall'utente 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()

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

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

Invio

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

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

Recupera l'indirizzo di lavoro di questo contatto o una stringa vuota se non esiste.

Invio

String: l'indirizzo di lavoro di questo contatto o una 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

---

getWorkFax()

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

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

Invio

String: il numero di fax di lavoro di questo contatto o una 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()

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

Recupera il numero di telefono di lavoro di questo contatto o una stringa vuota se non esiste.

Invio

String: il numero di telefono di lavoro di questo contatto o una 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)

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

Rimuove questo 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
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

Parametri

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

Invio

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)

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

Imposta il cognome del contatto.

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

Parametri

Nome	Tipo	Descrizione
familyName	String	il nuovo cognome del contatto

Invio

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)

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

Parametri

Nome	Tipo	Descrizione
fullName	String	Il nuovo nome completo del contatto

Invio

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)

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setGivenName('Johnny');
}

Parametri

Nome	Tipo	Descrizione
givenName	String	il nuovo nome del contatto

Invio

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)

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

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

Imposta il numero di fax di casa di questo 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)

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

Imposta il numero di telefono di casa di 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)

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setInitials('JD');
}

Parametri

Nome	Tipo	Descrizione
initials	String	le nuove iniziali del contatto

Invio

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)

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('Jane Doe');
for (const i in contacts) {
  contacts[i].setMaidenName('Smith');
}

Parametri

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

Invio

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)

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setMiddleName('Danger');
}

Parametri

Nome	Tipo	Descrizione
middleName	String	Il nuovo secondo nome del contatto

Invio

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)

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

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

Parametri

Nome	Tipo	Descrizione
nickname	String	il nuovo nickname del contatto

Invio

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)

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

Imposta le note associate a questo contatto.

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

Parametri

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

Invio

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)

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

Imposta il numero del pager di questo contatto.

Parametri

Nome	Tipo	Descrizione
phone	String	il numero del pager 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)

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setPrefix('Mr');
}

Parametri

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

Invio

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)

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

Ritiro. 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"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setShortName('John');
}

Parametri

Nome	Tipo	Descrizione
shortName	String	il nuovo nome breve del contatto

Invio

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)

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

Imposta il suffisso al nome del contatto.

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

Parametri

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

Invio

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)

Ritiro. 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 (String, int e così via)
value	String	Il valore può essere di qualsiasi tipo di base (String, 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)

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

Imposta i campi definiti dall'utente per questo 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)

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

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

Imposta il numero di fax di lavoro di questo 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)

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