Class IMField

IMField

تمّ إيقاف هذا العمود نهائيًا. بدلاً من ذلك، استخدِم خدمة People API المتقدمة.

حقل رسائل فورية في جهة اتصال

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
getAddress()	String	احصل على عنوان هذا الحقل.
getLabel()	Object	تحصل على تصنيف هذا الحقل.
isPrimary()	Boolean	تحصل على ما إذا كانت هذه هي قيمة الحقل الأساسي.
setAddress(address)	IMField	تُستخدَم لضبط عنوان هذا الحقل.
setAsPrimary()	IMField	ضبط هذا الحقل على "أساسي"
setLabel(field)	IMField	لضبط تصنيف هذا الحقل.
setLabel(label)	IMField	لضبط تصنيف هذا الحقل.

الطرق المتوقّفة

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
deleteIMField()	void	لحذف حقل المراسلة الفورية هذا.

مستندات تفصيلية

getAddress()

احصل على عنوان هذا الحقل.

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

الإرجاع

String: العنوان كسلسلة

التفويض

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

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

---

getLabel()

تحصل على تصنيف هذا الحقل. قد يكون هذا الحقل أو ExtendedField أو String.

// 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

---

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.
const contacts = ContactsApp.getContactsByName('John Doe');
const 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

المعلمات

الاسم	النوع	الوصف
address	String	العنوان الجديد

الإرجاع

IMField: هذا الحقل مفيد لإنشاء سلاسل.

التفويض

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

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

---

setAsPrimary()

ضبط هذا الحقل على "أساسي"

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

الإرجاع

IMField - حقل القيمة هذا للتسلسل

التفويض

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

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

المعلمات

الاسم	النوع	الوصف
field	Field	التصنيف العادي الجديد

الإرجاع

IMField - حقل القيمة هذا للتسلسل

التفويض

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

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

المعلمات

الاسم	النوع	الوصف
label	String	التصنيف الجديد لهذا الحقل

الإرجاع

IMField: هذا الحقل مفيد لإنشاء سلاسل.

التفويض

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

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

الطرق المتوقّفة

deleteIMField()

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

لحذف حقل المراسلة الفورية هذا.

// Retrieves and deletes the AIM instant messaging field for contact 'John
// Doe'
const contacts = ContactsApp.getContactsByName('John Doe');
const imFields = contacts[0].getIMs(ContactsApp.Field.AIM);
imFields[0].deleteIMField();

التفويض

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

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