Extrai o rótulo desse campo. Pode ser um campo, um ExtendedField ou uma 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());
}
Retorno
Object: o rótulo deste campo
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
https://www.google.com/m8/feeds
setLabel(label)
Define o rótulo desse 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');
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
https://www.google.com/m8/feeds
Métodos obsoletos
deleteCustomField()
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Exclui 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();
}
}
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
https://www.google.com/m8/feeds
getValue()
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Recebe o valor do 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());
}
Retorno
Object: o valor armazenado no campo
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
https://www.google.com/m8/feeds
setLabel(field)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Define o rótulo desse 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');
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
https://www.google.com/m8/feeds
setValue(value)
Obsoleto. Esta função foi descontinuada e não pode ser usada em novos scripts.
Define o valor desse 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');