Obtiene la etiqueta de este campo. Puede ser un campo, un campo ExtendedField o una string.
// 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());
}
Devolvedor
Object: Es la etiqueta de este campo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
setLabel(label)
Establece la etiqueta de este 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');
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
Métodos obsoletos
deleteCustomField()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Borra este 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();
}
}
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
getValue()
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Obtiene el valor 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());
}
Devolvedor
Object: El valor almacenado en el campo
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
setLabel(field)
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Establece la etiqueta de este 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');
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
https://www.google.com/m8/feeds
setValue(value)
Obsoleto. Esta función es obsoleta y no debe utilizarse en nuevas secuencias de comandos.
Establece el valor de este 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');