Class CustomField

فیلد سفارشی

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

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

روش ها

روش	نوع برگشت	شرح مختصر
get Label()	Object	برچسب این فیلد را دریافت می کند.
set Label(label)	Custom Field	برچسب این فیلد را تنظیم می کند.

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

روش	نوع برگشت	شرح مختصر
delete Custom Field()	void	این فیلد را حذف می کند.
get Value()	Object	ارزش فیلد را می گیرد.
set Label(field)	Custom Field	برچسب این فیلد را تنظیم می کند.
set Value(value)	Custom Field	مقدار این فیلد را تعیین می کند.

مستندات دقیق

get Label()

برچسب این فیلد را دریافت می کند. این ممکن است یک فیلد، 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
for (let i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

بازگشت

Object - برچسب این فیلد

مجوز

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

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

---

set Label(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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

پارامترها

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

بازگشت

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

مجوز

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

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

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

delete Custom Field()

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

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

const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (let i = 0; i < fields.length; i++) {
  if (fields[i].getLabel() === 'foo') {
    fields[i].deleteCustomField();
  }
}

مجوز

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

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

---

get Value()

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

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

// Logs the value of all the custom fields for contact 'John Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (const i in fields) {
  Logger.log(fields[i].getValue());
}

بازگشت

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

مجوز

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

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

---

set Label(field)

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

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

// Sets the first custom field associated with contact 'John Doe' to use 'Mail
// application' as a label, with 'Gmail' as the value.
const contacts = ContactsApp.getContactsByName('John Doe');
const field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

پارامترها

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

بازگشت

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

مجوز

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

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

---

set Value(value)

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

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

// Sets the first custom field associated with contact 'John Doe' to use 'Mail
// application' as a label, with 'Gmail' as the value.
const contacts = ContactsApp.getContactsByName('John Doe');
const field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

پارامترها

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

بازگشت

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

مجوز

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

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