برچسب این فیلد را مانند "تولد" یا "سالگرد" تنظیم می کند.
مستندات دقیق
getLabel()
برچسب این فیلد را دریافت می کند. این ممکن است یک فیلد، ExtendedField یا یک رشته باشد.
// 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());
}
برگشت
Object - برچسب این فیلد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
https://www.google.com/m8/feeds
setLabel(label)
برچسب این فیلد را تنظیم می کند.
// 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');
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
https://www.google.com/m8/feeds
روش های منسوخ شده
deleteDateField()
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
این تاریخ را حذف می کند.
// 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();
}
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
https://www.google.com/m8/feeds
getDay()
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
روز ماه را برای این تاریخ دریافت می کند.
توجه: برای آبجکتهای استاندارد تاریخ جاوا اسکریپت، متد getDay() روز هفته را برمیگرداند.
// 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());
برگشت
Integer - روز ماه
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
https://www.google.com/m8/feeds
getMonth()
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
ماه این تاریخ را دریافت می کند.
// 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());
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
https://www.google.com/m8/feeds
getYear()
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
سال این تاریخ را دریافت می کند.
// 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());
برگشت
عدد Integer - سال
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
https://www.google.com/m8/feeds
setDate(month, day)
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
تاریخ را بدون یک سال به امروز تنظیم می کند.
این روش فقط برای فیلدهای تاریخ که به یک سال نیاز ندارند، مانند تاریخ تولد، اعمال می شود.
// 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);
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
https://www.google.com/m8/feeds
setDate(month, day, year)
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
تاریخ را به این روز تنظیم می کند.
// 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);
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
https://www.google.com/m8/feeds
setLabel(label)
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
برچسب این فیلد را مانند "تولد" یا "سالگرد" تنظیم می کند.
// 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);