Class EmailField

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

المَعلمات

الاسم	Type	الوصف
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);

المَعلمات

الاسم	Type	الوصف
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');

المَعلمات

الاسم	Type	الوصف
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');

المَعلمات

الاسم	Type	الوصف
name	String	الاسم المعروض الجديد لعنوان البريد الإلكتروني هذا

استرجاع الكرة

EmailField: حقل البريد الإلكتروني هذا مفيد للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

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