این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class EmailField

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

فیلد ایمیل در مخاطب

روش ها

روش	نوع برگشت	شرح مختصر
`getAddress()`	`String`	آدرس این فیلد را دریافت کنید.
`getLabel()`	`Object`	برچسب این فیلد را دریافت می کند.
`isPrimary()`	`Boolean`	دریافت می کند که آیا این مقدار فیلد اصلی است یا خیر.
`setAddress(address)`	`EmailField`	آدرس این فیلد را تنظیم می کند.
`setAsPrimary()`	`EmailField`	این فیلد را روی اولیه قرار می دهد.
`setLabel(field)`	`EmailField`	برچسب این فیلد را تنظیم می کند.
`setLabel(label)`	`EmailField`	برچسب این فیلد را تنظیم می کند.

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

روش	نوع برگشت	شرح مختصر
`deleteEmailField()`	`void`	این آدرس ایمیل را از مخاطب حذف می کند.
`getDisplayName()`	`String`	نام نمایشی این آدرس ایمیل را برمی گرداند.
`setDisplayName(name)`	`EmailField`	نام نمایشی این آدرس ایمیل را تنظیم می کند.

مستندات دقیق

`getAddress()`

آدرس این فیلد را دریافت کنید.

// Logs the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

بازگشت

String - آدرس به عنوان یک رشته

مجوز

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

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

`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

`isPrimary()`

دریافت می کند که آیا این مقدار فیلد اصلی است یا خیر.

// Logs whether or not the first address field associated with contact
// 'John Doe' is labeled as primary. This method can be similarly called
// for any field.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

بازگشت

Boolean - آیا این اولیه است

مجوز

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

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

`setAddress(address)`

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

// Sets the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

پارامترها

نام	تایپ کنید	توضیحات
`address`	`String`	آدرس جدید

بازگشت

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

مجوز

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

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

`setAsPrimary()`

این فیلد را روی اولیه قرار می دهد.

// Sets the the first address field associated with contact 'John Doe'
// as primary. This method can be similarly called for any field.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setAsPrimary();

بازگشت

EmailField - این FieldValue برای زنجیره زدن

مجوز

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

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

`setLabel(field)`

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

// Sets the label to 'Work' 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(ContactsApp.Field.WORK_ADDRESS);

پارامترها

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

بازگشت

EmailField - این FieldValue برای زنجیره زدن

مجوز

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

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`	برچسب جدید برای این زمینه

بازگشت

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

مجوز

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

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

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

`deleteEmailField()`

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

این آدرس ایمیل را از مخاطب حذف می کند.

// Retrieves and deletes the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].deleteEmailField();

مجوز

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

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

`getDisplayName()`

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

نام نمایشی این آدرس ایمیل را برمی گرداند.

// Logs the display name for the the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
Logger.log(workEmail[0].getDisplayName());

بازگشت

String - نام نمایشی این ایمیل

مجوز

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

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

`setDisplayName(name)`

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

نام نمایشی این آدرس ایمیل را تنظیم می کند.

// Sets the display name to 'Doe, John' for the the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].setDisplayName('Doe, John');

پارامترها

نام	تایپ کنید	توضیحات
`name`	`String`	نام نمایشی جدید برای این آدرس ایمیل

بازگشت

EmailField - این فیلد ایمیل، برای زنجیره کردن مفید است

مجوز

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

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