Class CustomField

CustomField

منسوخ شده است. در عوض، از سرویس پیشرفته People API استفاده کنید

یک فیلد سفارشی در یک مخاطب

روش ها

روش	نوع برگشت	شرح مختصر
getLabel()	Object	برچسب این فیلد را دریافت می کند.
setLabel(label)	CustomField	برچسب این فیلد را تنظیم می کند.

روش های منسوخ شده

روش	نوع برگشت	شرح مختصر
deleteCustomField()	void	این فیلد را حذف می کند.
getValue()	Object	ارزش فیلد را می گیرد.
setLabel(field)	CustomField	برچسب این فیلد را تنظیم می کند.
setValue(value)	CustomField	مقدار این فیلد را تعیین می کند.

مستندات دقیق

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');

پارامترها

نام	تایپ کنید	توضیحات
label	String	برچسب جدید برای این زمینه

بازگشت

CustomField - این فیلد برای زنجیره‌بندی مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

روش های منسوخ شده

deleteCustomField()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

این فیلد را حذف می کند.

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

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

getValue()

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

ارزش فیلد را می گیرد.

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

بازگشت

Object - مقدار ذخیره شده در فیلد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

setLabel(field)

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

برچسب این فیلد را تنظیم می کند.

// 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');

پارامترها

نام	تایپ کنید	توضیحات
field	ExtendedField	برچسب استاندارد جدید

بازگشت

CustomField - این فیلد برای زنجیره‌بندی مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

setValue(value)

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

مقدار این فیلد را تعیین می کند.

// 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');

پارامترها

نام	تایپ کنید	توضیحات
value	Object	ارزش جدید

بازگشت

CustomField - این فیلد برای زنجیره‌بندی مفید است

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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