Class CustomField

CampoPersonalizzato

Ritiro. Utilizza invece il servizio avanzato dell'API People

Un campo personalizzato in un contatto.

Metodi

Metodo	Tipo restituito	Breve descrizione
getLabel()	Object	Recupera l'etichetta di questo campo.
setLabel(label)	CustomField	Imposta l'etichetta di questo campo.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
deleteCustomField()	void	Elimina questo campo.
getValue()	Object	Recupera il valore del campo.
setLabel(field)	CustomField	Imposta l'etichetta di questo campo.
setValue(value)	CustomField	Imposta il valore di questo campo.

Documentazione dettagliata

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

---

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

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

deleteCustomField()

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

Elimina questo campo.

const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (let i = 0; i < fields.length; i++) {
  if (fields[i].getLabel() === 'foo') {
    fields[i].deleteCustomField();
  }
}

Autorizzazione

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

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

---

getValue()

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

Recupera il valore del campo.

// Logs the value of all the custom fields for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (const i in fields) {
  Logger.log(fields[i].getValue());
}

Invio

Object: il valore memorizzato nel campo

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)

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

Imposta l'etichetta di questo campo.

// Sets the first custom field associated with contact 'John Doe' to use 'Mail
// application' as a label, with 'Gmail' as the value.
const contacts = ContactsApp.getContactsByName('John Doe');
const field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

Parametri

Nome	Tipo	Descrizione
field	ExtendedField	la nuova etichetta standard

Invio

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

---

setValue(value)

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

Imposta il valore di questo campo.

// Sets the first custom field associated with contact 'John Doe' to use 'Mail
// application' as a label, with 'Gmail' as the value.
const contacts = ContactsApp.getContactsByName('John Doe');
const field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

Parametri

Nome	Tipo	Descrizione
value	Object	il nuovo valore

Invio

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