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

المعلمات

الاسم	النوع	الوصف
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