تمّ إيقاف هذا العمود نهائيًا. بدلاً من ذلك، استخدِم خدمة People API المتقدمة.
تحتوي جهة الاتصال على الاسم والعنوان وتفاصيل الاتصال المختلفة الخاصة بها.
الطرق المتوقّفة
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
|
| تُضيف عنوانًا إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص. |
|
| تُضيف شركة إلى جهة الاتصال. |
|
| تُضيف حقلًا مخصّصًا إلى جهة الاتصال باستخدام تصنيف موسّع أو مخصّص. |
|
| تُضيف هذه الدالة تاريخًا إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص. |
|
| إضافة عنوان بريد إلكتروني بتصنيف عادي (المنزل أو العمل أو غير ذلك) أو تصنيف مخصّص
{@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. |
|
| تُضيف عنوانًا لمحادثة فورية إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص. |
|
| تُضيف هذه الوسيطة رقم هاتف إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص. |
|
| تُضيف جهة الاتصال هذه إلى مجموعة جهات الاتصال المحدّدة. |
|
| تُضيف عنوان URL إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص. |
| void | يؤدي إلى حذف جهة الاتصال هذه. |
|
| الحصول على جميع عناوين جهة الاتصال هذه |
|
| تحصل على جميع عناوين جهة الاتصال هذه التي تتطابق مع حقل معيّن. |
|
| الحصول على جميع الشركات لجهة الاتصال هذه |
|
| الحصول على جميع مجموعات جهات الاتصال التي تحتوي على جهة الاتصال هذه |
|
| تحصل على جميع الحقول المخصّصة لجهة الاتصال هذه. |
|
| تحصل على جميع الحقول المخصّصة لجهة الاتصال هذه التي تتطابق مع حقل معيّن. |
|
| الحصول على جميع تواريخ جهة الاتصال هذه |
|
| تحصل على جميع تواريخ جهة الاتصال هذه التي تتطابق مع حقل معيّن. |
| String[] | الحصول على قائمة بعناوين البريد الإلكتروني المتاحة لجهة الاتصال هذه |
|
| تحصل على عناوين البريد الإلكتروني لجهة الاتصال هذه. |
|
| تحصل على عناوين البريد الإلكتروني لجهة الاتصال هذه التي تتطابق مع حقل معيّن. |
| String | تحصل على اسم العائلة (الاسم الأخير) لجهة الاتصال كسلسلة. |
| String | تحصل على الاسم الكامل (الاسم الأول واسم العائلة) لجهة الاتصال كسلسلة. |
| String | تحصل على الاسم المعرِّف (الاسم الأول) لجهة الاتصال كسلسلة. |
| String | تحصل على عنوان المنزل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان. |
| String | تحصل على رقم الفاكس المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا. |
| String | تحصل على رقم الهاتف المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا. |
|
| الحصول على جميع عناوين المراسلة الفورية لجهة الاتصال هذه |
|
| تحصل على جميع عناوين المراسلة الفورية لجهة الاتصال هذه التي تتطابق مع حقل معيّن. |
| String | تعرِض هذه السمة المعرّف الفريد لجهة الاتصال هذه. |
| String | للحصول على الأحرف الأولى من اسم جهة الاتصال |
| Date | تحصل على تاريخ آخر تعديل لجهة الاتصال هذه. |
| String | تحصل على اسم العائلة قبل الزواج لجهة الاتصال كسلسلة. |
| String | تحصل على الاسم الأوسط لجهة الاتصال كسلسلة. |
| String | تحصل على رقم الهاتف الجوّال لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا. |
| String | الحصول على لقب جهة الاتصال كسلسلة |
| String | تحصل على الملاحظات المرتبطة بجهة الاتصال هذه، أو سلسلة فارغة إذا لم تكن هناك ملاحظات. |
| String | تحصل على رقم هاتف جهاز البيبيلر الخاص بجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم. |
|
| الحصول على جميع أرقام الهواتف لجهة الاتصال هذه |
|
| تحصل على جميع أرقام هواتف جهة الاتصال هذه التي تتطابق مع حقل معيّن. |
| String | تحصل على البادئة لاسم جهة الاتصال. |
| String | تحصل على عنوان البريد الإلكتروني الأساسي لجهة الاتصال كسلسلة. |
| String | للحصول على الاسم المختصر لجهة الاتصال كسلسلة. |
| String | الحصول على اللاحقة لاسم جهة الاتصال |
|
| تحصل على جميع عناوين URL لجهة الاتصال هذه. |
|
| تحصل على جميع عناوين URL لجهة الاتصال هذه التي تتطابق مع حقل معيّن. |
| String | تحصل على القيمة التي حدّدها المستخدم والمرتبطة بالمفتاح المحدّد. |
| Object | تحصل على جميع الحقول التي يحدّدها المستخدم لجهة الاتصال هذه وتُعيدها كسمات كائن JavaScript. |
| String | تحصل على عنوان العمل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان. |
| String | تحصل على رقم الفاكس الخاص بالعمل لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم. |
| String | تحصل على رقم هاتف العمل لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا. |
|
| تؤدي هذه العملية إلى إزالة جهة الاتصال هذه من مجموعة جهات الاتصال المحدّدة. |
|
| لضبط اسم العائلة (الاسم الأخير) لجهة الاتصال |
|
| لضبط الاسم الكامل (الاسم الأول واسم العائلة) لجهة الاتصال. |
|
| لضبط الاسم المعرِّف (الاسم الأول) لجهة الاتصال. |
| void | تُستخدَم لضبط عنوان المنزل لجهة الاتصال هذه. |
| void | لضبط رقم الفاكس المنزلي لجهة الاتصال هذه. |
| void | لضبط رقم هاتف المنزل لجهة الاتصال هذه. |
|
| لضبط الأحرف الأولى من اسم جهة الاتصال |
|
| لضبط الاسم قبل الزواج لجهة الاتصال |
|
| لضبط الاسم الأوسط لجهة الاتصال |
| void | تُستخدَم لضبط رقم الهاتف الجوّال لجهة الاتصال هذه. |
|
| لضبط اللقب لجهة الاتصال |
|
| لضبط الملاحظات المرتبطة بهذه جهة الاتصال. |
| void | تُستخدَم لضبط رقم جهاز البيبيلر لجهة الاتصال هذه. |
|
| تُستخدَم لضبط البادئة على اسم جهة الاتصال. |
| void | لضبط عنوان البريد الإلكتروني الأساسي لجهة الاتصال هذه. |
|
| لضبط الاسم المختصر لجهة الاتصال |
|
| تُستخدَم لضبط اللاحقة على اسم جهة الاتصال. |
| void | تُستخدَم لضبط حقل واحد يحدّده المستخدم لجهة الاتصال هذه، ليتم تخزينه باستخدام مفتاح معيّن. |
| void | تُستخدَم لضبط الحقول التي يحدّدها المستخدم لجهة الاتصال هذه باستخدام سمات العنصر المحدّد. |
| void | لضبط عنوان العمل لجهة الاتصال هذه. |
| void | لضبط رقم الفاكس الخاص بجهة الاتصال هذه في العمل |
| void | لضبط رقم هاتف العمل لجهة الاتصال هذه. |
الطرق المتوقّفة
addAddress(label, address)
addAddress(label, address)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُضيف عنوانًا إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and adds the address // "123 Main St, Some City, NY 10011" with the ContactsApp.Field.WORK_ADDRESS // label. const contacts = ContactsApp.getContactsByName('John Doe'); const address = contacts[0].addAddress( ContactsApp.Field.WORK_ADDRESS, '123 Main St, Some City, NY 10011', );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | تصنيف العنوان الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة |
address | String | العنوان الجديد |
الإرجاع
: الحقل الذي تم إنشاؤه حديثًاAddress
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
addCompany(company, title)
addCompany(company, title)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُضيف شركة إلى جهة الاتصال.
// The code below retrieves a contact named "John Doe" and adds the company // "Google" and the job title "Product Manager". const contacts = ContactsApp.getContactsByName('John Doe'); const url = contacts[0].addCompany('Google', 'Product Manager');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
company | String | اسم الشركة المطلوب إضافتها إلى جهة الاتصال هذه |
title | String | المسمّى الوظيفي المرتبط بجهة الاتصال هذه للشركة |
الإرجاع
: الحقل الذي تم إنشاؤه حديثًاCompany
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
addCustomField(label, content)
addCustomField(label, content)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُضيف حقلًا مخصّصًا إلى جهة الاتصال باستخدام تصنيف موسّع أو مخصّص.
يمكن أن يكون التصنيف من ContactsApp.ExtendedField أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and adds the custom field // ContactsApp.ExtendedField.HOBBY with the value "hiking". // Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field // named 'HOBBY'. const contacts = ContactsApp.getContactsByName('John Doe'); contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | تصنيف العنوان الجديد، إما من ContactsApp.ExtendedField أو سلسلة مخصّصة |
content | Object | القيمة المطلوب تخزينها في الحقل المخصّص |
الإرجاع
: الحقل الذي تم إنشاؤه حديثًاCustom
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
addDate(label, month, day, year)
addDate(label, month, day, year)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُضيف هذه الدالة تاريخًا إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and adds a // ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950". const contacts = ContactsApp.getContactsByName('John Doe'); const birthday = contacts[0].addDate( ContactsApp.Field.BIRTHDAY, ContactsApp.Month.APRIL, 19, 1950, );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | تصنيف التاريخ الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة |
month | Month | الشهر، من ContactApps.Month |
day | Integer | اليوم |
year | Integer | السنة |
الإرجاع
: تاريخ الإنشاء الجديدDate
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
addEmail(label, address)
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. const contacts = ContactsApp.getContactsByName('John Doe'); const emailField = contacts[0].addEmail( ContactsApp.Field.HOME_EMAIL, 'j.doe@example.com', );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | تصنيف الرسالة الإلكترونية الجديدة، إما من ContactsApp.Field أو سلسلة مخصّصة |
address | String | عنوان البريد الإلكتروني الجديد |
الإرجاع
: الحقل الذي تمت إضافته حديثًاEmail
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
addIM(label, address)
addIM(label, address)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُضيف عنوانًا لمحادثة فورية إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and adds the IM address // "ChatWithJohn" with the ContactsApp.Field.AIM label. const contacts = ContactsApp.getContactsByName('John Doe'); const email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | تصنيف عنوان المراسلة الفورية الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة |
address | String | عنوان المراسلة الفورية الجديد |
الإرجاع
: الحقل الذي تم إنشاؤه حديثًاIMField
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
addPhone(label, number)
addPhone(label, number)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُضيف هذه الوسيطة رقم هاتف إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and adds the phone number // "212-555-1234" with the ContactsApp.Field.WORK_PHONE label. const contacts = ContactsApp.getContactsByName('John Doe'); const phone = contacts[0].addPhone( ContactsApp.Field.WORK_PHONE, '212-555-1234', );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | تصنيف رقم الهاتف الجديد، إما من ContactsApp.Field أو من سلسلة مخصّصة |
number | String | رقم الهاتف الجديد |
الإرجاع
: الحقل الذي تم إنشاؤه حديثًاPhone
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
addToGroup(group)
addToGroup(group)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُضيف جهة الاتصال هذه إلى مجموعة جهات الاتصال المحدّدة.
// The code below creates a new contact and then adds it to the contact group // named "Work Friends" let contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com'); const group = ContactsApp.getContactGroup('Work Friends'); contact = contact.addToGroup(group);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
group |
| مجموعة جهات الاتصال التي تريد إضافة جهة الاتصال هذه إليها |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
addUrl(label, url)
addUrl(label, url)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُضيف عنوان URL إلى جهة الاتصال باستخدام تصنيف عادي أو مخصّص.
يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and adds the URL // "http://www.example.com" with the ContactsApp.Field.WORK_WEBSITE label. const contacts = ContactsApp.getContactsByName('John Doe'); const url = contacts[0].addUrl( ContactsApp.Field.WORK_WEBSITE, 'http://www.example.com', );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | تصنيف العنوان الجديد، إما من ContactsApp.Field أو سلسلة مخصّصة |
url | String | عنوان URL الجديد |
الإرجاع
: الحقل الذي تم إنشاؤه حديثًاUrl
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
deleteContact()
deleteContact()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
يؤدي إلى حذف جهة الاتصال هذه.
const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { contacts[i].deleteContact(); }
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getAddresses()
getAddresses()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على جميع عناوين جهة الاتصال هذه
// The code below logs the addresses of all the contacts whose names contain // "John Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getAddresses()); }
الإرجاع
- قائمة العناوينAddress
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getAddresses(label)
getAddresses(label)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع عناوين جهة الاتصال هذه التي تتطابق مع حقل معيّن.
يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and logs the addresses // associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS // label. const contacts = ContactsApp.getContactsByName('John Doe'); const addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS); for (const i in addresses) { Logger.log(addresses[i].getAddress()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة |
الإرجاع
- قائمة العناوينAddress
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getCompanies()
getCompanies()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على جميع الشركات لجهة الاتصال هذه
// The code below logs the company names of all the contacts whose names contain // "John Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { const companies = contacts[i].getCompanies(); for (const j in companies) { Logger.log(companies[j].getCompanyName()); } }
الإرجاع
- قائمة بالشركاتCompany
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getContactGroups()
getContactGroups()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على جميع مجموعات جهات الاتصال التي تحتوي على جهة الاتصال هذه
// The code below gets a contact named "John Doe" and retrieves all the contact // groups that the contact belongs to const contacts = ContactsApp.getContactsByName('John Doe'); const groups = contacts[0].getContactGroups();
الإرجاع
: المجموعات التي تحتوي على جهة الاتصال هذهContact
انظر أيضًا
getCustomFields()
getCustomFields()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع الحقول المخصّصة لجهة الاتصال هذه.
// The code below retrieves a contact named "John Doe" and logs the custom // fields associated with that contact const contacts = ContactsApp.getContactsByName('John Doe'); const fields = contacts[0].getCustomFields(); for (const i in fields) { Logger.log(fields[i].getValue()); }
الإرجاع
: قائمة بالحقول المخصّصةCustom
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getCustomFields(label)
getCustomFields(label)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع الحقول المخصّصة لجهة الاتصال هذه التي تتطابق مع حقل معيّن.
يمكن أن يكون التصنيف إما تصنيفًا عاديًا من ContactsApp.ExtendedField أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and logs the custom // fields associated with that contact that are in the // ContactsApp.ExtendedField.HOBBY label. const contacts = ContactsApp.getContactsByName('John Doe'); const hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY); for (const i in hobbies) { Logger.log(hobbies[i].getValue()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | التصنيف المطلوب مطابقته، إما من ContactsApp.ExtendedField أو سلسلة مخصّصة |
الإرجاع
: قائمة بالحقول المخصّصةCustom
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getDates()
getDates()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على جميع تواريخ جهة الاتصال هذه
// The code below retrieves a contact named "John Doe" and logs the label of the // date associated with that contact const contacts = ContactsApp.getContactsByName('John Doe'); const dates = contacts[0].getDates(); for (const i in dates) { Logger.log(dates[i].getLabel()); }
الإرجاع
- قائمة بالتواريخDate
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getDates(label)
getDates(label)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع تواريخ جهة الاتصال هذه التي تتطابق مع حقل معيّن.
يمكن أن يكون التصنيف إما تصنيفًا عاديًا من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and logs the day of the // month associated with that contact that are in the ContactsApp.Field.BIRTHDAY // label. const contacts = ContactsApp.getContactsByName('John Doe'); const birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY); for (const i in birthdays) { Logger.log(birthdays[i].getDay()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة |
الإرجاع
- قائمة بالتواريخDate
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getEmailAddresses()
getEmailAddresses()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على قائمة بعناوين البريد الإلكتروني المتاحة لجهة الاتصال هذه
الإرجاع
String[]
: قائمة بعناوين البريد الإلكتروني المتاحة لجهة الاتصال هذه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getEmails()
getEmails()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على عناوين البريد الإلكتروني لجهة الاتصال هذه.
// The code below retrieves a contact named "John Doe" and logs the email // addresses associated with that contact const contacts = ContactsApp.getContactsByName('John Doe'); const emails = contacts[0].getEmails(); for (const i in emails) { Logger.log(emails[i].getAddress()); }
الإرجاع
: قائمة عناوين البريد الإلكتروني لجهة الاتصالEmail
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getEmails(label)
getEmails(label)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على عناوين البريد الإلكتروني لجهة الاتصال هذه التي تتطابق مع حقل معيّن.
يمكن أن يكون التصنيف إما تصنيفًا عاديًا من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and logs the email // addresses associated with that contact that are in the // ContactsApp.Field.HOME_EMAIL label. const contacts = ContactsApp.getContactsByName('John Doe'); const emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL); for (const i in emails) { Logger.log(emails[i].getAddress()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة |
الإرجاع
: قائمة عناوين البريد الإلكتروني لجهة الاتصالEmail
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getFamilyName()
getFamilyName()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على اسم العائلة (الاسم الأخير) لجهة الاتصال كسلسلة.
// The code below logs the family name of all the contacts whose names contain // "John" const contacts = ContactsApp.getContactsByName('John'); for (const i in contacts) { Logger.log(contacts[i].getFamilyName()); }
الإرجاع
String
: اسم عائلة جهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getFullName()
getFullName()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على الاسم الكامل (الاسم الأول واسم العائلة) لجهة الاتصال كسلسلة.
// The code below logs the full name of all the contacts whose names contain // "John" const contacts = ContactsApp.getContactsByName('John'); for (const i in contacts) { Logger.log(contacts[i].getFullName()); }
الإرجاع
String
: الاسم الكامل لجهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getGivenName()
getGivenName()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على الاسم المعرِّف (الاسم الأول) لجهة الاتصال كسلسلة.
// The code below logs the given name of all the contacts whose names contain // "Smith" const contacts = ContactsApp.getContactsByName('Smith'); for (const i in contacts) { Logger.log(contacts[i].getGivenName()); }
الإرجاع
String
: الاسم المعرِّف لجهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getHomeAddress()
getHomeAddress()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على عنوان المنزل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان.
الإرجاع
String
: عنوان المنزل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getHomeFax()
getHomeFax()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على رقم الفاكس المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.
الإرجاع
String
: رقم الفاكس المنزلي لجهة الاتصال هذه أو سلسلة فارغة في حال عدم توفّر رقم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getHomePhone()
getHomePhone()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على رقم الهاتف المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.
الإرجاع
String
: رقم الهاتف المنزلي لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getIMs()
getIMs()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على جميع عناوين المراسلة الفورية لجهة الاتصال هذه
// The code below logs the IM addresses of all the contacts whose names contain // "John Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getIMs()); }
الإرجاع
- قائمة بعناوين المراسلة الفوريةIMField[]
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getIMs(label)
getIMs(label)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع عناوين المراسلة الفورية لجهة الاتصال هذه التي تتطابق مع حقل معيّن.
يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and logs the IM addresses // associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK // label. const contacts = ContactsApp.getContactsByName('John Doe'); const imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK); for (const i in imAddresses) { Logger.log(imAddresses[i].getAddress()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة |
الإرجاع
- قائمة بعناوين المراسلة الفوريةIMField[]
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getId()
getId()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تعرِض هذه السمة المعرّف الفريد لجهة الاتصال هذه.
const contact = ContactsApp.createContact( 'John', 'Doe', 'john.doe@example.com', ); const id = contact.getId();
الإرجاع
String
: رقم تعريف جهة الاتصال هذه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getInitials()
getInitials()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
للحصول على الأحرف الأولى من اسم جهة الاتصال
// The code below logs the initials of all the contacts whose names contain // "John Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getInitials()); }
الإرجاع
String
: الأحرف الأولى من اسم جهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getLastUpdated()
getLastUpdated()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على تاريخ آخر تعديل لجهة الاتصال هذه.
// The code below logs the last updated date of all the contacts whose names // contain "John Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getLastUpdated()); }
الإرجاع
Date
: تاريخ آخر تعديل لجهة الاتصال هذه
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getMaidenName()
getMaidenName()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على اسم العائلة قبل الزواج لجهة الاتصال كسلسلة.
// The code below logs the maiden name of all the contacts whose names contain // "Jane" const contacts = ContactsApp.getContactsByName('Jane'); for (const i in contacts) { Logger.log(contacts[i].getMaidenName()); }
الإرجاع
String
: اسم جهة الاتصال قبل الزواج
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getMiddleName()
getMiddleName()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على الاسم الأوسط لجهة الاتصال كسلسلة.
// The code below logs the middle name of all the contacts whose names contain // "Smith" const contacts = ContactsApp.getContactsByName('Smith'); for (const i in contacts) { Logger.log(contacts[i].getMiddleName()); }
الإرجاع
String
: الاسم الأوسط لجهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getMobilePhone()
getMobilePhone()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على رقم الهاتف الجوّال لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.
الإرجاع
String
: رقم الهاتف الجوّال لجهة الاتصال هذه أو سلسلة فارغة في حال عدم توفّر رقم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getNickname()
getNickname()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على لقب جهة الاتصال كسلسلة
// The code below logs the nickname of all the contacts whose names contain // "John Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getNickname()); }
الإرجاع
String
: لقب جهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getNotes()
getNotes()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على الملاحظات المرتبطة بجهة الاتصال هذه، أو سلسلة فارغة إذا لم تكن هناك ملاحظات.
// The code below logs the notes of all the contacts whose names contain "John // Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getNotes()); }
الإرجاع
String
- الملاحظات المرتبطة بهذه جهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getPager()
getPager()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على رقم هاتف جهاز البيبيلر الخاص بجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم.
الإرجاع
String
: رقم هاتف جهاز البيبيلون لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getPhones()
getPhones()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على جميع أرقام الهواتف لجهة الاتصال هذه
// The code below logs the phone numbers of all the contacts whose names contain // "John Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getPhones()); }
الإرجاع
- قائمة بأرقام الهواتفPhone
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getPhones(label)
getPhones(label)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع أرقام هواتف جهة الاتصال هذه التي تتطابق مع حقل معيّن.
يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and logs the phone // numbers associated with that contact that are in the // ContactsApp.Field.WORK_PHONE label. const contacts = ContactsApp.getContactsByName('John Doe'); const phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE); for (const i in phones) { Logger.log(phones[i].getPhoneNumber()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة |
الإرجاع
- قائمة بأرقام الهواتفPhone
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getPrefix()
getPrefix()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على البادئة لاسم جهة الاتصال.
// The code below logs the prefix of all the contacts whose names contain "John // Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getPrefix()); }
الإرجاع
String
: البادئة لاسم جهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getPrimaryEmail()
getPrimaryEmail()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على عنوان البريد الإلكتروني الأساسي لجهة الاتصال كسلسلة.
// The code below logs the primary email address of all the contacts whose names // contain "John Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getPrimaryEmail()); }
الإرجاع
String
: عنوان البريد الإلكتروني الأساسي لجهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getShortName()
getShortName()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
للحصول على الاسم المختصر لجهة الاتصال كسلسلة.
// The code below logs the short name of all the contacts whose names contain // "Johnathan" const contacts = ContactsApp.getContactsByName('Johnathan'); for (const i in contacts) { Logger.log(contacts[i].getShortName()); }
الإرجاع
String
: الاسم المختصر لجهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getSuffix()
getSuffix()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
الحصول على اللاحقة لاسم جهة الاتصال
// The code below logs the suffix of all the contacts whose names contain "John // Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getSuffix()); }
الإرجاع
String
: اللاحقة لاسم جهة الاتصال
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getUrls()
getUrls()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع عناوين URL لجهة الاتصال هذه.
// The code below logs the URLs of all the contacts whose names contain "John // Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { Logger.log(contacts[i].getUrls()); }
الإرجاع
: قائمة بعناوين URLUrl
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getUrls(label)
getUrls(label)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع عناوين URL لجهة الاتصال هذه التي تتطابق مع حقل معيّن.
يمكن أن يكون التصنيف من ContactsApp.Field أو سلسلة تصنيف مخصّصة.
// The code below retrieves a contact named "John Doe" and logs the URLs // associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE // label. const contacts = ContactsApp.getContactsByName('John Doe'); const urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE); for (const i in urls) { Logger.log(urls[i].getAddress()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
label | Object | التصنيف المطلوب مطابقته، إما من ContactsApp.Field أو سلسلة مخصّصة |
الإرجاع
: قائمة بعناوين URLUrl
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
getUserDefinedField(key)
getUserDefinedField(key)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على القيمة التي حدّدها المستخدم والمرتبطة بالمفتاح المحدّد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | يمكن أن يكون المفتاح أي نوع أساسي (سلسلة أو عدد صحيح أو غير ذلك). |
الإرجاع
String
: المحتوى الذي حدّده المستخدم والذي تم تخزينه باستخدام هذا المفتاح
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getUserDefinedFields()
getUserDefinedFields()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على جميع الحقول التي يحدّدها المستخدم لجهة الاتصال هذه وتُعيدها كسمات كائن JavaScript.
الإرجاع
Object
: الحقول التي حدّدها المستخدم لجهة الاتصال هذه، بصفتها سمات لكائن JavaScript
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getWorkAddress()
getWorkAddress()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على عنوان العمل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان.
الإرجاع
String
- عنوان العمل لجهة الاتصال هذه، أو سلسلة فارغة إذا لم يكن هناك عنوان
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getWorkFax()
getWorkFax()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على رقم الفاكس الخاص بالعمل لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن هناك رقم.
الإرجاع
String
: رقم الفاكس للعمل لجهة الاتصال هذه أو سلسلة فارغة في حال عدم توفّر رقم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
getWorkPhone()
getWorkPhone()
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تحصل على رقم هاتف العمل لجهة الاتصال هذه أو سلسلة فارغة إذا لم يكن متوفّرًا.
الإرجاع
String
: رقم هاتف العمل لجهة الاتصال هذه أو سلسلة فارغة في حال عدم توفّر رقم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
removeFromGroup(group)
removeFromGroup(group)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تؤدي هذه العملية إلى إزالة جهة الاتصال هذه من مجموعة جهات الاتصال المحدّدة.
// The code below gets all the contacts named "John Doe" and then removes each // of them from the "Work Friends" contact group const contacts = ContactsApp.getContactsByName('John Doe'); const group = ContactsApp.getContactGroup('Work Friends'); for (const i in contacts) { contacts[i] = contacts[i].removeFromGroup(group); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
group |
| مجموعة جهات الاتصال التي تريد إزالة جهة الاتصال هذه منها |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setFamilyName(familyName)
setFamilyName(familyName)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط اسم العائلة (الاسم الأخير) لجهة الاتصال
// The code below changes the family name of all the contacts whose names are // "John Doe" to "Doe-Smith" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { contacts[i].setFamilyName('Doe-Smith'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
family | String | اسم العائلة الجديد لجهة الاتصال |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setFullName(fullName)
setFullName(fullName)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط الاسم الكامل (الاسم الأول واسم العائلة) لجهة الاتصال.
// The code below changes the full name of all the contacts whose names are // "John Doe" to "Johnny Doe" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { contacts[i].setFullName('Johnny Doe'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
full | String | الاسم الكامل الجديد لجهة الاتصال |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setGivenName(givenName)
setGivenName(givenName)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط الاسم المعرِّف (الاسم الأول) لجهة الاتصال.
// The code below changes the given name of all the contacts whose names are // "John Doe" to "Johnny" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { contacts[i].setGivenName('Johnny'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
given | String | الاسم المعرِّف الجديد لجهة الاتصال |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setHomeAddress(addr)
setHomeAddress(addr)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُستخدَم لضبط عنوان المنزل لجهة الاتصال هذه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
addr | String | عنوان المنزل المطلوب ضبطه |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setHomeFax(phone)
setHomeFax(phone)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط رقم الفاكس المنزلي لجهة الاتصال هذه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
phone | String | رقم الفاكس المنزلي المطلوب ضبطه |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setHomePhone(phone)
setHomePhone(phone)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط رقم هاتف المنزل لجهة الاتصال هذه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
phone | String | رقم هاتف المنزل المطلوب ضبطه |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setInitials(initials)
setInitials(initials)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط الأحرف الأولى من اسم جهة الاتصال
// The code below sets the initials of all the contacts whose names are // "Johnathan Doe" to "JD" const contacts = ContactsApp.getContactsByName('Johnathan Doe'); for (const i in contacts) { contacts[i].setInitials('JD'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
initials | String | الأحرف الأولى الجديدة لجهة الاتصال |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setMaidenName(maidenName)
setMaidenName(maidenName)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط الاسم قبل الزواج لجهة الاتصال
// The code below changes the maiden name of all the contacts whose names are // "Jane Doe" to "Smith" const contacts = ContactsApp.getContactsByName('Jane Doe'); for (const i in contacts) { contacts[i].setMaidenName('Smith'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
maiden | String | الاسم الجديد لجهة الاتصال قبل الزواج |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setMiddleName(middleName)
setMiddleName(middleName)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط الاسم الأوسط لجهة الاتصال
// The code below changes the middle name of all the contacts whose names are // "John Doe" to "Danger" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { contacts[i].setMiddleName('Danger'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
middle | String | الاسم الأوسط الجديد لجهة الاتصال |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setMobilePhone(phone)
setMobilePhone(phone)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُستخدَم لضبط رقم الهاتف الجوّال لجهة الاتصال هذه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
phone | String | رقم الهاتف الجوّال المطلوب ضبطه |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setNickname(nickname)
setNickname(nickname)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط اللقب لجهة الاتصال
// The code below changes the nickname of all the contacts whose names are "John // Doe" to "JohnnyD" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { contacts[i].setNickname('JohnnyD'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
nickname | String | اللقب الجديد لجهة الاتصال |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setNotes(notes)
setNotes(notes)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط الملاحظات المرتبطة بهذه جهة الاتصال.
// The code below sets the notes of all the contacts whose names are "John Doe" // to "Met him at the hackathon" const contacts = ContactsApp.getContactsByName('John Doe'); for (const i in contacts) { contacts[i].setNotes('Met him at the hackathon'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
notes | String | الملاحظات التي سيتم تخزينها لجهة الاتصال هذه |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setPager(phone)
setPager(phone)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُستخدَم لضبط رقم جهاز البيبيلر لجهة الاتصال هذه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
phone | String | رقم جهاز الببغاوات لضبطه |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setPrefix(prefix)
setPrefix(prefix)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُستخدَم لضبط البادئة على اسم جهة الاتصال.
// The code below sets the prefix of all the contacts whose names are "Johnathan // Doe" to "Mr" const contacts = ContactsApp.getContactsByName('Johnathan Doe'); for (const i in contacts) { contacts[i].setPrefix('Mr'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
prefix | String | البادئة الجديدة لاسم جهة الاتصال |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setPrimaryEmail(primaryEmail)
setPrimaryEmail(primaryEmail)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط عنوان البريد الإلكتروني الأساسي لجهة الاتصال هذه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
primary | String | عنوان البريد الإلكتروني الرئيسي المطلوب ضبطه |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setShortName(shortName)
setShortName(shortName)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط الاسم المختصر لجهة الاتصال
// The code below changes the short name of all the contacts whose names are // "Johnathan Doe" to "John" const contacts = ContactsApp.getContactsByName('Johnathan Doe'); for (const i in contacts) { contacts[i].setShortName('John'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
short | String | الاسم المختصر الجديد لجهة الاتصال |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setSuffix(suffix)
setSuffix(suffix)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُستخدَم لضبط اللاحقة على اسم جهة الاتصال.
// The code below sets the suffix of all the contacts whose names are "Johnathan // Doe" to "Jr" const contacts = ContactsApp.getContactsByName('Johnathan Doe'); for (const i in contacts) { contacts[i].setSuffix('Jr'); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
suffix | String | اللاحقة الجديدة لاسم جهة الاتصال |
الإرجاع
- جهة الاتصال هذهContact
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
انظر أيضًا
setUserDefinedField(key, value)
setUserDefinedField(key, value)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُستخدَم لضبط حقل واحد يحدّده المستخدم لجهة الاتصال هذه، ليتم تخزينه باستخدام مفتاح معيّن.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | يمكن أن يكون المفتاح أي نوع أساسي (سلسلة أو عدد صحيح أو غير ذلك). |
value | String | يمكن أن تكون القيمة أي نوع أساسي (سلسلة أو عدد صحيح أو غير ذلك). |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setUserDefinedFields(o)
setUserDefinedFields(o)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تُستخدَم لضبط الحقول التي يحدّدها المستخدم لجهة الاتصال هذه باستخدام سمات العنصر المحدّد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
o | Object | عنصر يحتوي على سمة واحدة أو أكثر في الشكل {key: value} |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setWorkAddress(addr)
setWorkAddress(addr)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط عنوان العمل لجهة الاتصال هذه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
addr | String | عنوان العمل المطلوب ضبطه |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setWorkFax(phone)
setWorkFax(phone)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط رقم الفاكس الخاص بجهة الاتصال هذه في العمل
المعلمات
الاسم | النوع | الوصف |
---|---|---|
phone | String | رقم فاكس العمل المطلوب ضبطه |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds
setWorkPhone(phone)
setWorkPhone(phone)
تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
لضبط رقم هاتف العمل لجهة الاتصال هذه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
phone | String | رقم هاتف العمل المطلوب ضبطه |
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.google.com/m8/feeds