Class CustomField

CustomField

Obsoleta. Utilizza invece la versione avanzata dell'API People servizio

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	Ottiene 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 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Invio

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

Invio

CustomField: questo campo, utile per concatenare

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.

Ottiene 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());
}

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)

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

Invio

CustomField: questo campo, utile per concatenare

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

Invio

CustomField: questo campo, utile per concatenare

Autorizzazione

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

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