تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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)`

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

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

يمكن أن يكون التصنيف من ContactsApp.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');

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addCompany('Google', 'Product Manager');

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].addDate(ContactsApp.Field.BIRTHDAY,
                                   ContactsApp.Month.APRIL, 19, 1950);

المَعلمات

الاسم	Type	الوصف
`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
// "j.doe@example.com" to the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emailField = contacts[0].addEmail(ContactsApp.Field.HOME_EMAIL, 'j.doe@example.com');

المَعلمات

الاسم	Type	الوصف
`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 the ContactsApp.Field.AIM label.
var contacts = ContactsApp.getContactsByName('John Doe');
var email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

المَعلمات

الاسم	Type	الوصف
`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 the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phone = contacts[0].addPhone(ContactsApp.Field.WORK_PHONE, '212-555-1234');

المَعلمات

الاسم	Type	الوصف
`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', 'john.doe@example.com');
var group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
`label`	`Object`	تصنيف العنوان الجديد، إما من ContactsApp.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)`

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

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

يمكن أن يكون التصنيف من 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.
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());
}

المَعلمات

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

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

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

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

المَعلمات

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

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

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

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

المَعلمات

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

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

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

يمكن أن يكون التصنيف إما تصنيفًا عاديًا من 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.
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());
}

المَعلمات

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

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

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

يمكن أن يكون التصنيف من 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.
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());
}

المَعلمات

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

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

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

التفويض

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

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

يمكن أيضًا مراجعة

addIM(label, address)

`getId()`

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

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

var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
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)`

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

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

يمكن أن يكون التصنيف من 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.
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());
}

المَعلمات

الاسم	Type	الوصف
`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"
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 لجهة الاتصال هذه التي تتطابق مع حقل معيّن.

يمكن أن يكون التصنيف من 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.
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());
}

المَعلمات

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

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

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

التفويض

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

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

يمكن أيضًا مراجعة

addUrl(label, url)

`getUserDefinedField(key)`

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

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
`givenName`	`String`	الاسم الجديد لجهة الاتصال

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

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

التفويض

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

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

يمكن أيضًا مراجعة

getGivenName()

`setHomeAddress(addr)`

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

تعيين عنوان المنزل لجهة الاتصال هذه.

المَعلمات

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

التفويض

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

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

`setHomeFax(phone)`

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

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

المَعلمات

الاسم	Type	الوصف
`phone`	`String`	رقم فاكس المنزل لضبط

التفويض

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

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

`setHomePhone(phone)`

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

تعيين رقم هاتف المنزل لجهة الاتصال هذه.

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

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

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

التفويض

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

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

يمكن أيضًا مراجعة

getMiddleName()

`setMobilePhone(phone)`

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

لتعيين رقم الهاتف الجوّال لجهة الاتصال هذه.

المَعلمات

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

المَعلمات

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

المَعلمات

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

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

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

التفويض

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

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

يمكن أيضًا مراجعة

getNotes()

`setPager(phone)`

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

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

المَعلمات

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

المَعلمات

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

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

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

التفويض

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

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

يمكن أيضًا مراجعة

getPrefix()

`setPrimaryEmail(primaryEmail)`

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

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

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

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

التفويض

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

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

يمكن أيضًا مراجعة

getSuffix()

`setUserDefinedField(key, value)`

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

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

المَعلمات

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

التفويض

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

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

`setUserDefinedFields(o)`

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

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

المَعلمات

الاسم	Type	الوصف
`o`	`Object`	كائن له خاصية واحدة أو أكثر بالصيغة {key: value}

التفويض

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

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

`setWorkAddress(addr)`

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

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

المَعلمات

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

التفويض

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

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

`setWorkFax(phone)`

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

تعيين رقم فاكس العمل لجهة الاتصال هذه.

المَعلمات

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

التفويض

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

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

`setWorkPhone(phone)`

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

تعيين رقم هاتف العمل لجهة الاتصال هذه.

المَعلمات

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

التفويض

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

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