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	أضِف عنوان بريد إلكتروني يحمل تصنيفًا عاديًا (المنزل، العمل، إلخ) أو تصنيفًا مخصّصًا.
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)

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

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

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

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

المعلمات

الاسم	النوع	الوصف
label	Object	تصنيف العنوان الجديد، إما من ContactApp.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".
var contacts = ContactsApp.getContactsByName('John Doe');
var 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'.
var contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا

• getCustomFields()

---

addDate(label, month, day, year)

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

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

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

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

المعلمات

الاسم	النوع	الوصف
label	Object	تصنيف التاريخ الجديد، إما من ContactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var emailField = contacts[0].addEmail(ContactsApp.Field.HOME_EMAIL, '[e-mail]');

المعلمات

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

الإرجاع

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

التفويض

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

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

---

addIM(label, address)

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا

• getIMs()

---

addPhone(label, number)

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

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

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

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var 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"
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا

• removeFromGroup(group)

---

addUrl(label, url)

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا

• getUrls()

---

deleteContact()

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

لحذف جهة الاتصال هذه.

var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

الإرجاع

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

التفويض

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

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

انظر أيضًا

• addAddress(label, address)

---

getAddresses(label)

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

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

ويمكن أن يكون التصنيف إما من ContactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (var i in addresses) {
  Logger.log(addresses[i].getAddress());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactApp.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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  var companies = contacts[i].getCompanies();
  for (var 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
var contacts = ContactsApp.getContactsByName('John Doe');
var 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
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i in fields) {
  Logger.log(fields[i].getValue());
}

الإرجاع

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

التفويض

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

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

انظر أيضًا

• addCustomField(label, content)

---

getCustomFields(label)

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

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

يمكن أن يكون التصنيف إما تصنيفًا عاديًا من ContactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (var 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
var contacts = ContactsApp.getContactsByName('John Doe');
var dates = contacts[0].getDates();
for (var i in dates) {
  Logger.log(dates[i].getLabel());
}

الإرجاع

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

التفويض

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

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

انظر أيضًا

• addDate(label, month, day, year)

---

getDates(label)

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

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

يمكن أن يكون التصنيف إما تصنيفًا عاديًا من ContactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (var i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactApp.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
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails();
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

الإرجاع

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

التفويض

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

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

انظر أيضًا

• addEmail(label, address)

---

getEmails(label)

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

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

يمكن أن يكون التصنيف إما تصنيفًا عاديًا من ContactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactApp.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"
var contacts = ContactsApp.getContactsByName('John');
for (var 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"
var contacts = ContactsApp.getContactsByName('John');
for (var 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"
var contacts = ContactsApp.getContactsByName('Smith');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getIMs());
}

الإرجاع

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

التفويض

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

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

انظر أيضًا

• addIM(label, address)

---

getIMs(label)

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

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

ويمكن أن يكون التصنيف إما من ContactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (var i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا

• addIM(label, address)

---

getId()

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

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

var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Jane');
for (var 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"
var contacts = ContactsApp.getContactsByName('Smith');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPhones());
}

الإرجاع

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

التفويض

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

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

انظر أيضًا

• addPhone(label, number)

---

getPhones(label)

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

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

ويمكن أن يكون التصنيف إما من ContactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (var i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

المعلمات

الاسم	النوع	الوصف
label	Object	التصنيف المطلوب مطابقته، إما من ContactApp.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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getUrls());
}

الإرجاع

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

التفويض

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

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

انظر أيضًا

• addUrl(label, url)

---

getUrls(label)

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

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

ويمكن أن يكون التصنيف إما من ContactApp.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.
var contacts = ContactsApp.getContactsByName('John Doe');
var urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (var i in urls) {
  Logger.log(urls[i].getAddress());
}

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا

• addUrl(label, url)

---

getUserDefinedField(key)

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

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

المعلمات

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

الإرجاع

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
var contacts = ContactsApp.getContactsByName('John Doe');
var group = ContactsApp.getContactGroup('Work Friends');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Jane Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setSuffix('Jr');
}

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا

• getSuffix()

---

setUserDefinedField(key, value)

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

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

المعلمات

الاسم	النوع	الوصف
key	String	يمكن أن يكون المفتاح من أي نوع أساسي (سلسلة أو int أو غير ذلك)
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