Class CustomField

CustomField

Obsoleta. Utilizza invece il servizio avanzato API People

Un campo personalizzato in un contatto.

Metodi

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

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
deleteCustomField()	void	Elimina questo campo.
getValue()	Object	Restituisce 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 per questo campo. Può essere un campo, un campo ExtendedField 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Ritorni

Object: l'etichetta per 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Parametri

Nome	Tipo	Descrizione
label	String	la nuova etichetta per questo campo

Ritorni

CustomField: questo campo è utile per il concatenamento

Autorizzazione

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

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

Metodi deprecati

deleteCustomField()

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

Elimina questo campo.

var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var 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()

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

Restituisce il valore del campo.

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

Ritorni

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)

Obsoleta. 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

Parametri

Nome	Tipo	Descrizione
field	ExtendedField	la nuova etichetta standard

Ritorni

CustomField: questo campo è utile per il concatenamento

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)

Obsoleta. 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

Parametri

Nome	Tipo	Descrizione
value	Object	il nuovo valore

Ritorni

CustomField: questo campo è utile per il concatenamento

Autorizzazione

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

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