Class Contact

التواصل

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

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

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

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

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

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

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

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

المعلمات

الاسمالنوعالوصف
labelObjectتصنيف العنوان الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة
addressStringالعنوان الجديد

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

الاسمالنوعالوصف
labelObjectتصنيف التاريخ الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة
monthMonthالشهر، من ContactApps.Month
dayIntegerاليوم
yearIntegerالسنة

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

// 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const emailField = contacts[0].addEmail(
    ContactsApp.Field.HOME_EMAIL,
    'j.doe@example.com',
);

المعلمات

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

الإرجاع

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

التفويض

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

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

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

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

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

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

المعلمات

الاسمالنوعالوصف
labelObjectتصنيف عنوان المراسلة الفورية الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة
addressStringعنوان المراسلة الفورية الجديد

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

// The code below creates a new contact and then adds it to the contact group
// named "Work Friends"
let contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
const group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

الاسمالنوعالوصف
labelObjectتصنيف العنوان الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة
urlStringعنوان URL الجديد

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

التفويض

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

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

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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

الإرجاع

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

التفويض

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

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

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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

الإرجاع

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

التفويض

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

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

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

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

الإرجاع

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

التفويض

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

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

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

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

الإرجاع

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

التفويض

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

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

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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);
const id = contact.getId();

الإرجاع

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

التفويض

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

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

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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

الإرجاع

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

التفويض

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

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

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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

الإرجاع

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

التفويض

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

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

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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

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

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

الإرجاع

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

التفويض

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

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

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

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

الإرجاع

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

التفويض

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

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

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

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

الإرجاع

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

التفويض

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

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

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

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

الإرجاع

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

التفويض

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

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

المعلمات

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

التفويض

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

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

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

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

المعلمات

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

التفويض

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

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

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

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

المعلمات

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

التفويض

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

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

المعلمات

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

التفويض

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

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

المعلمات

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

التفويض

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

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

المعلمات

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

التفويض

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

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

انظر أيضًا


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

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

المعلمات

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

التفويض

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

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

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

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

المعلمات

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

التفويض

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

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

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

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

المعلمات

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

التفويض

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

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

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

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

المعلمات

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

التفويض

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

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

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

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

المعلمات

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

التفويض

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

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