Class Contact

التواصل

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

تحتوي جهة الاتصال على الاسم والعنوان وتفاصيل الاتصال المختلفة الخاصة بها.

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

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
addAddress(label, address)	AddressField	تُضيف عنوانًا إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
addCompany(company, title)	CompanyField	تُضيف شركة إلى جهة الاتصال.
addCustomField(label, content)	CustomField	تُضيف حقلًا مخصّصًا إلى جهة الاتصال باستخدام تصنيف موسّع أو مخصّص.
addDate(label, month, day, year)	DateField	تُضيف هذه الدالة تاريخًا إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
addEmail(label, address)	EmailField	إضافة عنوان بريد إلكتروني بتصنيف عادي (المنزل أو العمل أو غير ذلك) أو تصنيف مخصّص {@code // The code below retrieves a contact named "John Doe" and adds the email // address "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
addIM(label, address)	IMField	تُضيف عنوانًا لمحادثة فورية إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
addPhone(label, number)	PhoneField	تُضيف هذه الوسيطة رقم هاتف إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
addToGroup(group)	Contact	تُضيف جهة الاتصال هذه إلى مجموعة جهات الاتصال المحدّدة.
addUrl(label, url)	UrlField	تُضيف عنوان URL إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
deleteContact()	void	يؤدي إلى حذف جهة الاتصال هذه.
getAddresses()	AddressField[]	الحصول على جميع عناوين جهة الاتصال هذه
getAddresses(label)	AddressField[]	تحصل على جميع عناوين جهة الاتصال هذه التي تتطابق مع حقل معيّن.
getCompanies()	CompanyField[]	الحصول على جميع الشركات لجهة الاتصال هذه
getContactGroups()	ContactGroup[]	الحصول على جميع مجموعات جهات الاتصال التي تحتوي على جهة الاتصال هذه
getCustomFields()	CustomField[]	تحصل على جميع الحقول المخصّصة لجهة الاتصال هذه.
getCustomFields(label)	CustomField[]	تحصل على جميع الحقول المخصّصة لجهة الاتصال هذه التي تتطابق مع حقل معيّن.
getDates()	DateField[]	الحصول على جميع تواريخ جهة الاتصال هذه
getDates(label)	DateField[]	تحصل على جميع تواريخ جهة الاتصال هذه التي تتطابق مع حقل معيّن.
getEmailAddresses()	String[]	الحصول على قائمة بعناوين البريد الإلكتروني المتاحة لجهة الاتصال هذه
getEmails()	EmailField[]	تحصل على عناوين البريد الإلكتروني لجهة الاتصال هذه.
getEmails(label)	EmailField[]	تحصل على عناوين البريد الإلكتروني لجهة الاتصال هذه التي تتطابق مع حقل معيّن.
getFamilyName()	String	تحصل على اسم العائلة (الاسم الأخير) لجهة الاتصال كسلسلة.
getFullName()	String	تحصل على الاسم الكامل (الاسم الأول واسم العائلة) لجهة الاتصال كسلسلة.
getGivenName()	String	تحصل على الاسم المعرِّف (الاسم الأول) لجهة الاتصال كسلسلة.
getHomeAddress()	String	تحصل على عنوان المنزل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان.
getHomeFax()	String	تحصل على رقم الفاكس المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.
getHomePhone()	String	تحصل على رقم الهاتف المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.
getIMs()	IMField[]	الحصول على جميع عناوين المراسلة الفورية لجهة الاتصال هذه
getIMs(label)	IMField[]	تحصل على جميع عناوين المراسلة الفورية لجهة الاتصال هذه التي تتطابق مع حقل معيّن.
getId()	String	تعرِض هذه السمة المعرّف الفريد لجهة الاتصال هذه.
getInitials()	String	للحصول على الأحرف الأولى من اسم جهة الاتصال
getLastUpdated()	Date	تحصل على تاريخ آخر تعديل لجهة الاتصال هذه.
getMaidenName()	String	تحصل على اسم العائلة قبل الزواج لجهة الاتصال كسلسلة.
getMiddleName()	String	تحصل على الاسم الأوسط لجهة الاتصال كسلسلة.
getMobilePhone()	String	تحصل على رقم الهاتف الجوّال لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.
getNickname()	String	الحصول على لقب جهة الاتصال كسلسلة
getNotes()	String	تحصل على الملاحظات المرتبطة بجهة الاتصال هذه، أو سلسلة فارغة إذا لم تكن هناك ملاحظات.
getPager()	String	تحصل على رقم هاتف جهاز البيبيلر الخاص بجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم.
getPhones()	PhoneField[]	الحصول على جميع أرقام الهواتف لجهة الاتصال هذه
getPhones(label)	PhoneField[]	تحصل على جميع أرقام هواتف جهة الاتصال هذه التي تتطابق مع حقل معيّن.
getPrefix()	String	تحصل على البادئة لاسم جهة الاتصال.
getPrimaryEmail()	String	تحصل على عنوان البريد الإلكتروني الأساسي لجهة الاتصال كسلسلة.
getShortName()	String	للحصول على الاسم المختصر لجهة الاتصال كسلسلة.
getSuffix()	String	الحصول على اللاحقة لاسم جهة الاتصال
getUrls()	UrlField[]	تحصل على جميع عناوين URL لجهة الاتصال هذه.
getUrls(label)	UrlField[]	تحصل على جميع عناوين URL لجهة الاتصال هذه التي تتطابق مع حقل معيّن.
getUserDefinedField(key)	String	تحصل على القيمة التي حدّدها المستخدم والمرتبطة بالمفتاح المحدّد.
getUserDefinedFields()	Object	تحصل على جميع الحقول التي يحدّدها المستخدم لجهة الاتصال هذه وتُعيدها كسمات كائن JavaScript.
getWorkAddress()	String	تحصل على عنوان العمل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان.
getWorkFax()	String	تحصل على رقم الفاكس الخاص بالعمل لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم.
getWorkPhone()	String	تحصل على رقم هاتف العمل لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.
removeFromGroup(group)	Contact	تؤدي هذه العملية إلى إزالة جهة الاتصال هذه من مجموعة جهات الاتصال المحدّدة.
setFamilyName(familyName)	Contact	لضبط اسم العائلة (الاسم الأخير) لجهة الاتصال
setFullName(fullName)	Contact	لضبط الاسم الكامل (الاسم الأول واسم العائلة) لجهة الاتصال.
setGivenName(givenName)	Contact	لضبط الاسم المعرِّف (الاسم الأول) لجهة الاتصال.
setHomeAddress(addr)	void	تُستخدَم لضبط عنوان المنزل لجهة الاتصال هذه.
setHomeFax(phone)	void	لضبط رقم الفاكس المنزلي لجهة الاتصال هذه.
setHomePhone(phone)	void	لضبط رقم هاتف المنزل لجهة الاتصال هذه.
setInitials(initials)	Contact	لضبط الأحرف الأولى من اسم جهة الاتصال
setMaidenName(maidenName)	Contact	لضبط الاسم قبل الزواج لجهة الاتصال
setMiddleName(middleName)	Contact	لضبط الاسم الأوسط لجهة الاتصال
setMobilePhone(phone)	void	تُستخدَم لضبط رقم الهاتف الجوّال لجهة الاتصال هذه.
setNickname(nickname)	Contact	لضبط اللقب لجهة الاتصال
setNotes(notes)	Contact	لضبط الملاحظات المرتبطة بهذه جهة الاتصال.
setPager(phone)	void	تُستخدَم لضبط رقم جهاز البيبيلر لجهة الاتصال هذه.
setPrefix(prefix)	Contact	تُستخدَم لضبط البادئة على اسم جهة الاتصال.
setPrimaryEmail(primaryEmail)	void	لضبط عنوان البريد الإلكتروني الأساسي لجهة الاتصال هذه.
setShortName(shortName)	Contact	لضبط الاسم المختصر لجهة الاتصال
setSuffix(suffix)	Contact	تُستخدَم لضبط اللاحقة على اسم جهة الاتصال.
setUserDefinedField(key, value)	void	تُستخدَم لضبط حقل واحد يحدّده المستخدم لجهة الاتصال هذه، ليتم تخزينه باستخدام مفتاح معيّن.
setUserDefinedFields(o)	void	تُستخدَم لضبط الحقول التي يحدّدها المستخدم لجهة الاتصال هذه باستخدام سمات العنصر المحدّد.
setWorkAddress(addr)	void	لضبط عنوان العمل لجهة الاتصال هذه.
setWorkFax(phone)	void	لضبط رقم الفاكس الخاص بجهة الاتصال هذه في العمل
setWorkPhone(phone)	void	لضبط رقم هاتف العمل لجهة الاتصال هذه.

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

addAddress(label, address)

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

تُضيف عنوانًا إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.

يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const address = contacts[0].addAddress(
    ContactsApp.Field.WORK_ADDRESS,
    '123 Main St, Some City, NY 10011',
);

المعلمات

الاسم	النوع	الوصف
label	Object	تصنيف العنوان الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة
address	String	العنوان الجديد

الإرجاع

AddressField: الحقل الذي تم إنشاؤه حديثًا

التفويض

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

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

انظر أيضًا

• getAddresses()

---

addCompany(company, title)

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

تُضيف شركة إلى جهة الاتصال.

// The code below retrieves a contact named "John Doe" and adds the company
// "Google" and the job title "Product Manager".
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addCompany('Google', 'Product Manager');

المعلمات

الاسم	النوع	الوصف
company	String	اسم الشركة المطلوب إضافتها إلى جهة الاتصال هذه
title	String	المسمّى الوظيفي المرتبط بجهة الاتصال هذه للشركة

الإرجاع

CompanyField: الحقل الذي تم إنشاؤه حديثًا

التفويض

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

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

انظر أيضًا

• getCompanies()

---

addCustomField(label, content)

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

تُضيف حقلًا مخصّصًا إلى جهة الاتصال باستخدام تصنيف موسّع أو مخصّص.

يمكن أن يكون التصنيف من ContactsApp.ExtendedField أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field
// named 'HOBBY'.
const contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

المعلمات

الاسم	النوع	الوصف
label	Object	تصنيف العنوان الجديد، إما من ContactsApp.ExtendedField أو سلسلة مخصّصة
content	Object	القيمة المطلوب تخزينها في الحقل المخصّص

الإرجاع

CustomField: الحقل الذي تم إنشاؤه حديثًا

التفويض

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

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

انظر أيضًا

• getCustomFields()

---

addDate(label, month, day, year)

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

تُضيف هذه الدالة تاريخًا إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.

يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].addDate(
    ContactsApp.Field.BIRTHDAY,
    ContactsApp.Month.APRIL,
    19,
    1950,
);

المعلمات

الاسم	النوع	الوصف
label	Object	تصنيف التاريخ الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة
month	Month	الشهر، من ContactApps.Month
day	Integer	اليوم
year	Integer	السنة

الإرجاع

DateField: تاريخ الإنشاء الجديد

التفويض

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

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

انظر أيضًا

• getDates()

---

addEmail(label, address)

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

إضافة عنوان بريد إلكتروني بتصنيف عادي (المنزل أو العمل أو غير ذلك) أو تصنيف مخصّص

// The code below retrieves a contact named "John Doe" and adds the email
// address "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emailField = contacts[0].addEmail(
    ContactsApp.Field.HOME_EMAIL,
    '[e-mail]',
);

المعلمات

الاسم	النوع	الوصف
label	Object	تصنيف الرسالة الإلكترونية الجديدة، إما من ContactsApp.Field أو سلسلة مخصّصة
address	String	عنوان البريد الإلكتروني الجديد

الإرجاع

EmailField: الحقل الذي تمت إضافته حديثًا

التفويض

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

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

---

addIM(label, address)

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

تُضيف عنوانًا لمحادثة فورية إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.

يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and adds the IM address
// "ChatWithJohn" with the ContactsApp.Field.AIM label.
const contacts = ContactsApp.getContactsByName('John Doe');
const email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

المعلمات

الاسم	النوع	الوصف
label	Object	تصنيف عنوان المراسلة الفورية الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة
address	String	عنوان المراسلة الفورية الجديد

الإرجاع

IMField: الحقل الذي تم إنشاؤه حديثًا

التفويض

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

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

انظر أيضًا

• getIMs()

---

addPhone(label, number)

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

تُضيف هذه الوسيطة رقم هاتف إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.

يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phone = contacts[0].addPhone(
    ContactsApp.Field.WORK_PHONE,
    '212-555-1234',
);

المعلمات

الاسم	النوع	الوصف
label	Object	تصنيف رقم الهاتف الجديد، إما من ContactsApp.Field أو من سلسلة مخصّصة
number	String	رقم الهاتف الجديد

الإرجاع

PhoneField: الحقل الذي تم إنشاؤه حديثًا

التفويض

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

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

انظر أيضًا

• getPhones()

---

addToGroup(group)

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

تُضيف جهة الاتصال هذه إلى مجموعة جهات الاتصال المحدّدة.

// The code below creates a new contact and then adds it to the contact group
// named "Work Friends"
let contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
const group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

المعلمات

الاسم	النوع	الوصف
group	ContactGroup	مجموعة جهات الاتصال التي تريد إضافة جهة الاتصال هذه إليها

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• removeFromGroup(group)

---

addUrl(label, url)

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

تُضيف عنوان URL إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.

يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the ContactsApp.Field.WORK_WEBSITE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addUrl(
    ContactsApp.Field.WORK_WEBSITE,
    'http://www.example.com',
);

المعلمات

الاسم	النوع	الوصف
label	Object	تصنيف العنوان الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة
url	String	عنوان URL الجديد

الإرجاع

UrlField: الحقل الذي تم إنشاؤه حديثًا

التفويض

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

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

انظر أيضًا

• getUrls()

---

deleteContact()

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

يؤدي إلى حذف جهة الاتصال هذه.

const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].deleteContact();
}

التفويض

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

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

---

getAddresses()

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

الحصول على جميع عناوين جهة الاتصال هذه

// The code below logs the addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

الإرجاع

AddressField[] - قائمة العناوين

التفويض

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

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

انظر أيضًا

• addAddress(label, address)

---

getAddresses(label)

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

تحصل على جميع عناوين جهة الاتصال هذه التي تتطابق مع حقل معيّن.

يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (const i in addresses) {
  Logger.log(addresses[i].getAddress());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة

الإرجاع

AddressField[] - قائمة العناوين

التفويض

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

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

انظر أيضًا

• addAddress(label, address)

---

getCompanies()

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

الحصول على جميع الشركات لجهة الاتصال هذه

// The code below logs the company names of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  const companies = contacts[i].getCompanies();
  for (const j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

الإرجاع

CompanyField[] - قائمة بالشركات

التفويض

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

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

انظر أيضًا

• addCompany(company, title)

---

getContactGroups()

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

الحصول على جميع مجموعات جهات الاتصال التي تحتوي على جهة الاتصال هذه

// The code below gets a contact named "John Doe" and retrieves all the contact
// groups that the contact belongs to
const contacts = ContactsApp.getContactsByName('John Doe');
const groups = contacts[0].getContactGroups();

الإرجاع

ContactGroup[]: المجموعات التي تحتوي على جهة الاتصال هذه

انظر أيضًا

• addToGroup(group)

---

getCustomFields()

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

تحصل على جميع الحقول المخصّصة لجهة الاتصال هذه.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (const i in fields) {
  Logger.log(fields[i].getValue());
}

الإرجاع

CustomField[]: قائمة بالحقول المخصّصة

التفويض

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

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

انظر أيضًا

• addCustomField(label, content)

---

getCustomFields(label)

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

تحصل على جميع الحقول المخصّصة لجهة الاتصال هذه التي تتطابق مع حقل معيّن.

يمكن أن يكون التصنيف إما تصنيفًا عاديًا من ContactsApp.ExtendedField أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact that are in the
// ContactsApp.ExtendedField.HOBBY label.
const contacts = ContactsApp.getContactsByName('John Doe');
const hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (const i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactsApp.ExtendedField أو سلسلة مخصّصة

الإرجاع

CustomField[]: قائمة بالحقول المخصّصة

التفويض

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

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

انظر أيضًا

• addCustomField(label, content)

---

getDates()

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

الحصول على جميع تواريخ جهة الاتصال هذه

// The code below retrieves a contact named "John Doe" and logs the label of the
// date associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (const i in dates) {
  Logger.log(dates[i].getLabel());
}

الإرجاع

‫DateField[] - قائمة بالتواريخ

التفويض

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

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

انظر أيضًا

• addDate(label, month, day, year)

---

getDates(label)

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

تحصل على جميع تواريخ جهة الاتصال هذه التي تتطابق مع حقل معيّن.

يمكن أن يكون التصنيف إما تصنيفًا عاديًا من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and logs the day of the
// month associated with that contact that are in the ContactsApp.Field.BIRTHDAY
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (const i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة

الإرجاع

‫DateField[] - قائمة بالتواريخ

التفويض

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

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

انظر أيضًا

• addDate(label, month, day, year)

---

getEmailAddresses()

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

الحصول على قائمة بعناوين البريد الإلكتروني المتاحة لجهة الاتصال هذه

الإرجاع

String[]: قائمة بعناوين البريد الإلكتروني المتاحة لجهة الاتصال هذه

التفويض

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

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

---

getEmails()

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

تحصل على عناوين البريد الإلكتروني لجهة الاتصال هذه.

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails();
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

الإرجاع

EmailField[]: قائمة عناوين البريد الإلكتروني لجهة الاتصال

التفويض

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

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

انظر أيضًا

• addEmail(label, address)

---

getEmails(label)

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

تحصل على عناوين البريد الإلكتروني لجهة الاتصال هذه التي تتطابق مع حقل معيّن.

يمكن أن يكون التصنيف إما تصنيفًا عاديًا من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact that are in the
// ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة

الإرجاع

EmailField[]: قائمة عناوين البريد الإلكتروني لجهة الاتصال

التفويض

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

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

انظر أيضًا

• addEmail(label, address)

---

getFamilyName()

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

تحصل على اسم العائلة (الاسم الأخير) لجهة الاتصال كسلسلة.

// The code below logs the family name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

الإرجاع

String: اسم عائلة جهة الاتصال

التفويض

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

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

انظر أيضًا

• setFamilyName(familyName)

---

getFullName()

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

تحصل على الاسم الكامل (الاسم الأول واسم العائلة) لجهة الاتصال كسلسلة.

// The code below logs the full name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFullName());
}

الإرجاع

String: الاسم الكامل لجهة الاتصال

التفويض

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

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

انظر أيضًا

• setFullName(fullName)

---

getGivenName()

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

تحصل على الاسم المعرِّف (الاسم الأول) لجهة الاتصال كسلسلة.

// The code below logs the given name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

الإرجاع

String: الاسم المعرِّف لجهة الاتصال

التفويض

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

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

انظر أيضًا

• setGivenName(givenName)

---

getHomeAddress()

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

تحصل على عنوان المنزل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان.

الإرجاع

String: عنوان المنزل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان

التفويض

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

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

---

getHomeFax()

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

تحصل على رقم الفاكس المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.

الإرجاع

‫String: رقم الفاكس المنزلي لجهة الاتصال هذه أو سلسلة فارغة في حال عدم توفّر رقم

التفويض

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

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

---

getHomePhone()

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

تحصل على رقم الهاتف المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.

الإرجاع

‫String: رقم الهاتف المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا

التفويض

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

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

---

getIMs()

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

الحصول على جميع عناوين المراسلة الفورية لجهة الاتصال هذه

// The code below logs the IM addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getIMs());
}

الإرجاع

IMField[] - قائمة بعناوين المراسلة الفورية

التفويض

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

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

انظر أيضًا

• addIM(label, address)

---

getIMs(label)

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

تحصل على جميع عناوين المراسلة الفورية لجهة الاتصال هذه التي تتطابق مع حقل معيّن.

يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (const i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة

الإرجاع

IMField[] - قائمة بعناوين المراسلة الفورية

التفويض

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

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

انظر أيضًا

• addIM(label, address)

---

getId()

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

تعرِض هذه السمة المعرّف الفريد لجهة الاتصال هذه.

const contact = ContactsApp.createContact(
    'John',
    'Doe',
    '[e-mail]',
);
const id = contact.getId();

الإرجاع

String: رقم تعريف جهة الاتصال هذه

التفويض

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

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

---

getInitials()

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

للحصول على الأحرف الأولى من اسم جهة الاتصال

// The code below logs the initials of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getInitials());
}

الإرجاع

String: الأحرف الأولى من اسم جهة الاتصال

التفويض

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

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

انظر أيضًا

• setInitials(initials)

---

getLastUpdated()

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

تحصل على تاريخ آخر تعديل لجهة الاتصال هذه.

// The code below logs the last updated date of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

الإرجاع

Date: تاريخ آخر تعديل لجهة الاتصال هذه

التفويض

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

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

---

getMaidenName()

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

تحصل على اسم العائلة قبل الزواج لجهة الاتصال كسلسلة.

// The code below logs the maiden name of all the contacts whose names contain
// "Jane"
const contacts = ContactsApp.getContactsByName('Jane');
for (const i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

الإرجاع

String: اسم جهة الاتصال قبل الزواج

التفويض

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

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

انظر أيضًا

• setMaidenName(maidenName)

---

getMiddleName()

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

تحصل على الاسم الأوسط لجهة الاتصال كسلسلة.

// The code below logs the middle name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

الإرجاع

String: الاسم الأوسط لجهة الاتصال

التفويض

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

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

انظر أيضًا

• setMiddleName(middleName)

---

getMobilePhone()

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

تحصل على رقم الهاتف الجوّال لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.

الإرجاع

‫String: رقم الهاتف الجوّال لجهة الاتصال هذه أو سلسلة فارغة في حال عدم توفّر رقم

التفويض

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

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

---

getNickname()

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

الحصول على لقب جهة الاتصال كسلسلة

// The code below logs the nickname of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNickname());
}

الإرجاع

String: لقب جهة الاتصال

التفويض

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

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

انظر أيضًا

• setNickname(nickname)

---

getNotes()

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

تحصل على الملاحظات المرتبطة بجهة الاتصال هذه، أو سلسلة فارغة إذا لم تكن هناك ملاحظات.

// The code below logs the notes of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNotes());
}

الإرجاع

String - الملاحظات المرتبطة بهذه جهة الاتصال

التفويض

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

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

انظر أيضًا

• setNotes(notes)

---

getPager()

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

تحصل على رقم هاتف جهاز البيبيلر الخاص بجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم.

الإرجاع

‫String: رقم هاتف جهاز البيبيلون لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم

التفويض

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

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

---

getPhones()

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

الحصول على جميع أرقام الهواتف لجهة الاتصال هذه

// The code below logs the phone numbers of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPhones());
}

الإرجاع

PhoneField[] - قائمة بأرقام الهواتف

التفويض

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

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

انظر أيضًا

• addPhone(label, number)

---

getPhones(label)

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

تحصل على جميع أرقام هواتف جهة الاتصال هذه التي تتطابق مع حقل معيّن.

يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and logs the phone
// numbers associated with that contact that are in the
// ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (const i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة

الإرجاع

PhoneField[] - قائمة بأرقام الهواتف

التفويض

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

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

انظر أيضًا

• addPhone(label, number)

---

getPrefix()

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

تحصل على البادئة لاسم جهة الاتصال.

// The code below logs the prefix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

الإرجاع

String: البادئة لاسم جهة الاتصال

التفويض

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

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

انظر أيضًا

• setPrefix(prefix)

---

getPrimaryEmail()

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

تحصل على عنوان البريد الإلكتروني الأساسي لجهة الاتصال كسلسلة.

// The code below logs the primary email address of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

الإرجاع

String: عنوان البريد الإلكتروني الأساسي لجهة الاتصال

التفويض

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

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

---

getShortName()

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

للحصول على الاسم المختصر لجهة الاتصال كسلسلة.

// The code below logs the short name of all the contacts whose names contain
// "Johnathan"
const contacts = ContactsApp.getContactsByName('Johnathan');
for (const i in contacts) {
  Logger.log(contacts[i].getShortName());
}

الإرجاع

String: الاسم المختصر لجهة الاتصال

التفويض

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

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

انظر أيضًا

• setShortName(shortName)

---

getSuffix()

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

الحصول على اللاحقة لاسم جهة الاتصال

// The code below logs the suffix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

الإرجاع

String: اللاحقة لاسم جهة الاتصال

التفويض

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

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

انظر أيضًا

• setSuffix(suffix)

---

getUrls()

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

تحصل على جميع عناوين URL لجهة الاتصال هذه.

// The code below logs the URLs of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getUrls());
}

الإرجاع

UrlField[]: قائمة بعناوين URL

التفويض

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

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

انظر أيضًا

• addUrl(label, url)

---

getUrls(label)

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

تحصل على جميع عناوين URL لجهة الاتصال هذه التي تتطابق مع حقل معيّن.

يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (const i in urls) {
  Logger.log(urls[i].getAddress());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة

الإرجاع

UrlField[]: قائمة بعناوين URL

التفويض

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

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

انظر أيضًا

• addUrl(label, url)

---

getUserDefinedField(key)

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

تحصل على القيمة التي حدّدها المستخدم والمرتبطة بالمفتاح المحدّد.

المعلمات

الاسم	النوع	الوصف
key	String	يمكن أن يكون المفتاح أي نوع أساسي (سلسلة أو عدد صحيح أو غير ذلك).

الإرجاع

String: المحتوى الذي حدّده المستخدم والذي تم تخزينه باستخدام هذا المفتاح

التفويض

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

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

---

getUserDefinedFields()

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

تحصل على جميع الحقول التي يحدّدها المستخدم لجهة الاتصال هذه وتُعيدها كسمات كائن JavaScript.

الإرجاع

‫Object: الحقول التي حدّدها المستخدم لجهة الاتصال هذه، بصفتها سمات لكائن JavaScript

التفويض

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

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

---

getWorkAddress()

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

تحصل على عنوان العمل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان.

الإرجاع

String - عنوان العمل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان

التفويض

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

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

---

getWorkFax()

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

تحصل على رقم الفاكس الخاص بالعمل لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم.

الإرجاع

‫String: رقم الفاكس للعمل لجهة الاتصال هذه أو سلسلة فارغة في حال عدم توفّر رقم

التفويض

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

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

---

getWorkPhone()

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

تحصل على رقم هاتف العمل لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.

الإرجاع

‫String: رقم هاتف العمل لجهة الاتصال هذه أو سلسلة فارغة في حال عدم توفّر رقم

التفويض

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

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

---

removeFromGroup(group)

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

تؤدي هذه العملية إلى إزالة جهة الاتصال هذه من مجموعة جهات الاتصال المحدّدة.

// The code below gets all the contacts named "John Doe" and then removes each
// of them from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

المعلمات

الاسم	النوع	الوصف
group	ContactGroup	مجموعة جهات الاتصال التي تريد إزالة جهة الاتصال هذه منها

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• addToGroup(group)

---

setFamilyName(familyName)

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

لضبط اسم العائلة (الاسم الأخير) لجهة الاتصال

// The code below changes the family name of all the contacts whose names are
// "John Doe" to "Doe-Smith"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

المعلمات

الاسم	النوع	الوصف
familyName	String	اسم العائلة الجديد لجهة الاتصال

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getFamilyName()

---

setFullName(fullName)

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

لضبط الاسم الكامل (الاسم الأول واسم العائلة) لجهة الاتصال.

// The code below changes the full name of all the contacts whose names are
// "John Doe" to "Johnny Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

المعلمات

الاسم	النوع	الوصف
fullName	String	الاسم الكامل الجديد لجهة الاتصال

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getFullName()

---

setGivenName(givenName)

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

لضبط الاسم المعرِّف (الاسم الأول) لجهة الاتصال.

// The code below changes the given name of all the contacts whose names are
// "John Doe" to "Johnny"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setGivenName('Johnny');
}

المعلمات

الاسم	النوع	الوصف
givenName	String	الاسم المعرِّف الجديد لجهة الاتصال

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getGivenName()

---

setHomeAddress(addr)

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

تُستخدَم لضبط عنوان المنزل لجهة الاتصال هذه.

المعلمات

الاسم	النوع	الوصف
addr	String	عنوان المنزل المطلوب ضبطه

التفويض

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

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

---

setHomeFax(phone)

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

لضبط رقم الفاكس المنزلي لجهة الاتصال هذه.

المعلمات

الاسم	النوع	الوصف
phone	String	رقم الفاكس المنزلي المطلوب ضبطه

التفويض

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

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

---

setHomePhone(phone)

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

لضبط رقم هاتف المنزل لجهة الاتصال هذه.

المعلمات

الاسم	النوع	الوصف
phone	String	رقم هاتف المنزل المطلوب ضبطه

التفويض

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

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

---

setInitials(initials)

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

لضبط الأحرف الأولى من اسم جهة الاتصال

// The code below sets the initials of all the contacts whose names are
// "Johnathan Doe" to "JD"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setInitials('JD');
}

المعلمات

الاسم	النوع	الوصف
initials	String	الأحرف الأولى الجديدة لجهة الاتصال

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getInitials()

---

setMaidenName(maidenName)

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

لضبط الاسم قبل الزواج لجهة الاتصال

// The code below changes the maiden name of all the contacts whose names are
// "Jane Doe" to "Smith"
const contacts = ContactsApp.getContactsByName('Jane Doe');
for (const i in contacts) {
  contacts[i].setMaidenName('Smith');
}

المعلمات

الاسم	النوع	الوصف
maidenName	String	الاسم الجديد لجهة الاتصال قبل الزواج

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getMaidenName()

---

setMiddleName(middleName)

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

لضبط الاسم الأوسط لجهة الاتصال

// The code below changes the middle name of all the contacts whose names are
// "John Doe" to "Danger"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setMiddleName('Danger');
}

المعلمات

الاسم	النوع	الوصف
middleName	String	الاسم الأوسط الجديد لجهة الاتصال

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getMiddleName()

---

setMobilePhone(phone)

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

تُستخدَم لضبط رقم الهاتف الجوّال لجهة الاتصال هذه.

المعلمات

الاسم	النوع	الوصف
phone	String	رقم الهاتف الجوّال المطلوب ضبطه

التفويض

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

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

---

setNickname(nickname)

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

لضبط اللقب لجهة الاتصال

// The code below changes the nickname of all the contacts whose names are "John
// Doe" to "JohnnyD"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

المعلمات

الاسم	النوع	الوصف
nickname	String	اللقب الجديد لجهة الاتصال

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getNickname()

---

setNotes(notes)

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

لضبط الملاحظات المرتبطة بهذه جهة الاتصال.

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

المعلمات

الاسم	النوع	الوصف
notes	String	الملاحظات التي سيتم تخزينها لجهة الاتصال هذه

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getNotes()

---

setPager(phone)

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

تُستخدَم لضبط رقم جهاز البيبيلر لجهة الاتصال هذه.

المعلمات

الاسم	النوع	الوصف
phone	String	رقم جهاز الببغاوات لضبطه

التفويض

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

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

---

setPrefix(prefix)

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

تُستخدَم لضبط البادئة على اسم جهة الاتصال.

// The code below sets the prefix of all the contacts whose names are "Johnathan
// Doe" to "Mr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setPrefix('Mr');
}

المعلمات

الاسم	النوع	الوصف
prefix	String	البادئة الجديدة لاسم جهة الاتصال

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getPrefix()

---

setPrimaryEmail(primaryEmail)

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

لضبط عنوان البريد الإلكتروني الأساسي لجهة الاتصال هذه.

المعلمات

الاسم	النوع	الوصف
primaryEmail	String	عنوان البريد الإلكتروني الرئيسي المطلوب ضبطه

التفويض

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

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

---

setShortName(shortName)

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

لضبط الاسم المختصر لجهة الاتصال

// The code below changes the short name of all the contacts whose names are
// "Johnathan Doe" to "John"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setShortName('John');
}

المعلمات

الاسم	النوع	الوصف
shortName	String	الاسم المختصر الجديد لجهة الاتصال

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getShortName()

---

setSuffix(suffix)

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

تُستخدَم لضبط اللاحقة على اسم جهة الاتصال.

// The code below sets the suffix of all the contacts whose names are "Johnathan
// Doe" to "Jr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setSuffix('Jr');
}

المعلمات

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

الإرجاع

Contact - جهة الاتصال هذه

التفويض

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

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

انظر أيضًا

• getSuffix()

---

setUserDefinedField(key, value)

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

تُستخدَم لضبط حقل واحد يحدّده المستخدم لجهة الاتصال هذه، ليتم تخزينه باستخدام مفتاح معيّن.

المعلمات

الاسم	النوع	الوصف
key	String	يمكن أن يكون المفتاح أي نوع أساسي (سلسلة أو عدد صحيح أو غير ذلك).
value	String	يمكن أن تكون القيمة أي نوع أساسي (سلسلة أو عدد صحيح أو غير ذلك).

التفويض

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

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

---

setUserDefinedFields(o)

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

تُستخدَم لضبط الحقول التي يحدّدها المستخدم لجهة الاتصال هذه باستخدام سمات العنصر المحدّد.

المعلمات

الاسم	النوع	الوصف
o	Object	عنصر يحتوي على سمة واحدة أو أكثر في الشكل {key: value}

التفويض

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

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

---

setWorkAddress(addr)

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

لضبط عنوان العمل لجهة الاتصال هذه.

المعلمات

الاسم	النوع	الوصف
addr	String	عنوان العمل المطلوب ضبطه

التفويض

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

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

---

setWorkFax(phone)

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

لضبط رقم الفاكس الخاص بجهة الاتصال هذه في العمل

المعلمات

الاسم	النوع	الوصف
phone	String	رقم فاكس العمل المطلوب ضبطه

التفويض

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

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

---

setWorkPhone(phone)

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

لضبط رقم هاتف العمل لجهة الاتصال هذه.

المعلمات

الاسم	النوع	الوصف
phone	String	رقم هاتف العمل المطلوب ضبطه

التفويض

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

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