Class EmailField

CampoEmail

Ritiro. Utilizza invece il servizio avanzato dell'API People

Un campo email in un contatto.

Metodi

Metodo	Tipo restituito	Breve descrizione
getAddress()	String	Ottieni l'indirizzo di questo campo.
getLabel()	Object	Recupera l'etichetta di questo campo.
isPrimary()	Boolean	Indica se si tratta del valore del campo principale.
setAddress(address)	EmailField	Imposta l'indirizzo di questo campo.
setAsPrimary()	EmailField	Imposta questo campo come principale.
setLabel(field)	EmailField	Imposta l'etichetta di questo campo.
setLabel(label)	EmailField	Imposta l'etichetta di questo campo.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
deleteEmailField()	void	Consente di eliminare questo indirizzo email dal contatto.
getDisplayName()	String	Restituisce il nome visualizzato per questo indirizzo email.
setDisplayName(name)	EmailField	Imposta il nome visualizzato per questo indirizzo email.

Documentazione dettagliata

getAddress()

Ottieni l'indirizzo di questo campo.

// Logs the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
const contacts = ContactsApp.getContactsByName('John Doe');
const homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

Invio

String: l'indirizzo come stringa

Autorizzazione

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

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

---

getLabel()

Recupera l'etichetta di questo campo. Può essere un campo, un campo esteso o una stringa.

// Logs the label for all the address fields associated with contact
// 'John Doe'. This method can be similarly called for any field that has
// a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Invio

Object: l'etichetta di questo campo

Autorizzazione

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

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

---

isPrimary()

Indica se si tratta del valore del campo principale.

// Logs whether or not the first address field associated with contact
// 'John Doe' is labeled as primary. This method can be similarly called
// for any field.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

Invio

Boolean: indica se è principale

Autorizzazione

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

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

---

setAddress(address)

Imposta l'indirizzo di questo campo.

// Sets the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
const contacts = ContactsApp.getContactsByName('John Doe');
const homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

Parametri

Nome	Tipo	Descrizione
address	String	il nuovo indirizzo

Invio

EmailField: questo campo, utile per l'accodamento

Autorizzazione

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

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

---

setAsPrimary()

Imposta questo campo come principale.

// Sets the first address field associated with contact 'John Doe'
// as primary. This method can be similarly called for any field.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setAsPrimary();

Invio

EmailField: questo FieldValue per l'accodamento

Autorizzazione

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

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

---

setLabel(field)

Imposta l'etichetta di questo campo.

// Sets the label to 'Work' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel(ContactsApp.Field.WORK_ADDRESS);

Parametri

Nome	Tipo	Descrizione
field	Field	la nuova etichetta standard

Invio

EmailField: questo FieldValue per l'accodamento

Autorizzazione

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

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

---

setLabel(label)

Imposta l'etichetta di questo campo.

// Sets the label to 'Apartment' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Parametri

Nome	Tipo	Descrizione
label	String	la nuova etichetta per questo campo

Invio

EmailField: questo campo, utile per l'accodamento

Autorizzazione

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

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

Metodi ritirati

deleteEmailField()

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

Consente di eliminare questo indirizzo email dal contatto.

// Retrieves and deletes the work email address for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].deleteEmailField();

Autorizzazione

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

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

---

getDisplayName()

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

Restituisce il nome visualizzato per questo indirizzo email.

// Logs the display name for the work email address for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
Logger.log(workEmail[0].getDisplayName());

Invio

String: il nome visualizzato per questa email

Autorizzazione

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

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

---

setDisplayName(name)

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

Imposta il nome visualizzato per questo indirizzo email.

// Sets the display name to 'Doe, John' for the work email address for contact
// 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].setDisplayName('Doe, John');

Parametri

Nome	Tipo	Descrizione
name	String	Il nuovo nome visualizzato per questo indirizzo email

Invio

EmailField: questo campo email, utile per l'accodamento

Autorizzazione

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

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