Imposta l'etichetta per questo campo, ad esempio "Compleanno" o "Anniversario".
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
DateField: 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
deleteDateField()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Elimina questa data.
// Deletes all the dates that are set for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var dates = contacts[0].getDates();
for (var i = 0; i < dates.length; i++) {
dates[i].deleteDateField();
}
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
https://www.google.com/m8/feeds
getDay()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Visualizza il giorno del mese per questa data.
Nota: per gli oggetti Data JavaScript standard, il metodo getDay() restituisce invece il giorno della settimana.
// Logs the day of the birthday for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getDay());
Ritorni
Integer: il giorno del mese
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
https://www.google.com/m8/feeds
getMonth()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Visualizza il mese per questa data.
// Logs the month of the birthday for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getMonth());
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
https://www.google.com/m8/feeds
getYear()
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Visualizza l'anno per questa data.
// Logs the year of the birthday for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
Logger.log(birthday.getYear());
Ritorni
Integer: l'anno
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
https://www.google.com/m8/feeds
setDate(month, day)
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Imposta la data sul giorno corrente, senza anno.
Questo metodo si applica solo ai campi di data che non richiedono un anno, come i compleanni.
// Sets the birthday for contact 'John Doe' to April 1
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1);
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
https://www.google.com/m8/feeds
setDate(month, day, year)
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Imposta la data su questo giorno.
// Sets the birthday for contact 'John Doe' to April 1, 1980
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].getDates(ContactsApp.Field.BIRTHDAY)[0];
birthday.setDate(ContactsApp.Month.APRIL, 1, 1980);
DateField: questa data, 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
setLabel(label)
Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.
Imposta l'etichetta per questo campo, ad esempio "Compleanno" o "Anniversario".
// Retrieves the first date that's set for contact 'John Doe' and re-labels
// it as an anniversary
var contacts = ContactsApp.getContactsByName('John Doe');
var firstDate = contacts[0].getDates()[0];
firstDate.setLabel(ContactsApp.Field.ANNIVERSARY);