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

Class ContactsApp

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

تسمح هذه الفئة للمستخدمين بالوصول إلى "جهات اتصال Google" الخاصة بهم وإنشاء جهات الاتصال المدرَجة فيها وإزالتها وتعديلها.

السمات المتوقّفة نهائيًا

الموقع	النوع	الوصف
`ExtendedField`	`ExtendedField`
`Field`	`Field`
`Gender`	`Gender`
`Month`	`Month`
`Priority`	`Priority`
`Sensitivity`	`Sensitivity`

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

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`createContact(givenName, familyName, email)`	`Contact`	لإنشاء جهة اتصال جديدة
`createContactGroup(name)`	`ContactGroup`	إنشاء مجموعة جهات اتصال بالاسم المحدَّد // The code below creates a new contact group named "Work Friends" const group = ContactsApp.createContactGroup('Work Friends');
`deleteContact(contact)`	`void`	لحذف جهة الاتصال.
`deleteContactGroup(group)`	`void`	لحذف مجموعة جهات الاتصال // The code below creates deletes the contact group named "Work Friends" const group = ContactsApp.getContactGroup('Work Friends'); ContactsApp.deleteContactGroup(group);
`findByEmailAddress(email)`	`Contact`	للعثور على جهة اتصال باستخدام عنوان البريد الإلكتروني المحدّد
`findContactGroup(name)`	`ContactGroup`	للعثور على مجموعة جهات اتصال بالاسم المحدّد
`getAllContacts()`	`Contact[]`	الحصول على جميع جهات الاتصال التي يملكها هذا المستخدم
`getContact(emailAddress)`	`Contact`	الحصول على جهة اتصال حسب عنوان البريد الإلكتروني
`getContactById(id)`	`Contact`	الحصول على جهة الاتصال باستخدام هذا المعرّف
`getContactGroup(name)`	`ContactGroup`	تحصل على مجموعة جهات اتصال بالاسم المحدَّد، أو تعرض قيمة فارغة في حال عدم العثور على مجموعة جهات اتصال كهذه.
`getContactGroupById(id)`	`ContactGroup`	تحصل على مجموعة جهات اتصال باستخدام المعرّف المحدّد، أو تعرض قيمة فارغة في حال عدم العثور على مجموعة جهات اتصال كهذه.
`getContactGroups()`	`ContactGroup[]`	الحصول على القائمة الكاملة لمجموعات جهات اتصال المستخدم
`getContacts()`	`Contact[]`	الحصول على جميع جهات اتصال المستخدم
`getContactsByAddress(query)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان
`getContactsByAddress(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان، يقتصر على حقل معيّن
`getContactsByAddress(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان، تقتصر على تصنيف العنوان المخصّص المحدّد
`getContactsByCompany(query)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع حقل الشركة
`getContactsByCustomField(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع قيمة معيّنة في حقل مخصّص
`getContactsByDate(month, day, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع شهر ويوم محدّدَين لحقل عادي معيّن
`getContactsByDate(month, day, year, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع شهر ويوم وسنة معيّنين لحقل عادي معيّن
`getContactsByDate(month, day, year, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع شهر ويوم وسنة معيّنين لحقل مخصّص معيّن
`getContactsByDate(month, day, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع شهر ويوم محدّدَين في حقل مخصّص معيّن
`getContactsByEmailAddress(query)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان بريد إلكتروني
`getContactsByEmailAddress(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان بريد إلكتروني، يقتصر على حقل معيّن
`getContactsByEmailAddress(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان بريد إلكتروني، يقتصر على تصنيف عنوان البريد الإلكتروني المخصّص المحدّد
`getContactsByGroup(group)`	`Contact[]`	الحصول على جهات الاتصال في مجموعة جهات اتصال معيّنة
`getContactsByIM(query)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان مراسلة فورية
`getContactsByIM(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان مراسلة فورية، يقتصر على حقل معيّن
`getContactsByIM(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان مراسلة فورية، يقتصر على التصنيف المخصّص المحدّد للمراسلة فورية
`getContactsByJobTitle(query)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع حقل المسمى الوظيفي
`getContactsByName(query)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع اسم
`getContactsByName(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع اسم معيّن، تقتصر على حقل معيّن
`getContactsByNotes(query)`	`Contact[]`	الحصول على جهات الاتصال التي تتطابق مع حقل "الملاحظات"
`getContactsByPhone(query)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع رقم هاتف
`getContactsByPhone(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع رقم هاتف، يقتصر على حقل معيّن
`getContactsByPhone(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع رقم هاتف، تقتصر على تصنيف رقم الهاتف المخصّص المحدّد
`getContactsByUrl(query)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان URL
`getContactsByUrl(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان URL، تقتصر على حقل معيّن
`getContactsByUrl(query, label)`	`Contact[]`	الحصول على جهات اتصال تتطابق مع عنوان URL، يقتصر على تصنيف عنوان URL المخصّص المحدّد

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

`createContact(givenName, familyName, email)`

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

لإنشاء جهة اتصال جديدة

// The code below creates a new contact with the name "John Doe" and the email
// address "john.doe@example.com".
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);

المعلمات

الاسم	النوع	الوصف
`givenName`	`String`	الاسم الأول لجهة الاتصال
`familyName`	`String`	الاسم الأخير لجهة الاتصال
`email`	`String`	عنوان البريد الإلكتروني لجهة الاتصال

الإرجاع

Contact: عنصر "جهة الاتصال" الذي تم إنشاؤه حديثًا

التفويض

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

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

انظر أيضًا

deleteContact(contact)

`createContactGroup(name)`

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

إنشاء مجموعة جهات اتصال بالاسم المحدَّد

// The code below creates a new contact group named "Work Friends"
const group = ContactsApp.createContactGroup('Work Friends');

المعلمات

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

الإرجاع

ContactGroup: مجموعة جهات الاتصال التي تم إنشاؤها حديثًا

التفويض

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

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

انظر أيضًا

deleteContactGroup(group)

`deleteContact(contact)`

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

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

// The code below retrieves a contact with the email address
// "john.doe@example.com" and then deletes that contact.
const contact = ContactsApp.getContact('john.doe@example.com');
ContactsApp.deleteContact(contact);

المعلمات

الاسم	النوع	الوصف
`contact`	`Contact`	جهة الاتصال المطلوب حذفها

التفويض

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

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

انظر أيضًا

createContact(givenName, familyName, email)

`deleteContactGroup(group)`

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

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

// The code below creates deletes the contact group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
ContactsApp.deleteContactGroup(group);

المعلمات

الاسم	النوع	الوصف
`group`	`ContactGroup`	مجموعة جهات الاتصال المطلوب حذفها

التفويض

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

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

انظر أيضًا

createContactGroup(name)

`findByEmailAddress(email)`

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

للعثور على جهة اتصال باستخدام عنوان البريد الإلكتروني المحدّد

المعلمات

الاسم	النوع	الوصف
`email`	`String`	عنوان البريد الإلكتروني لجهة الاتصال المطلوب العثور عليها

الإرجاع

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

التفويض

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

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

`findContactGroup(name)`

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

للعثور على مجموعة جهات اتصال بالاسم المحدّد

المعلمات

الاسم	النوع	الوصف
`name`	`String`	اسم مجموعة جهات الاتصال المطلوب العثور عليها

الإرجاع

ContactGroup: مجموعة جهات الاتصال التي تتطابق مع الاسم المحدَّد

التفويض

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

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

`getAllContacts()`

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

الحصول على جميع جهات الاتصال التي يملكها هذا المستخدم

الإرجاع

Contact[] - كل جهات اتصال هذا المستخدم

التفويض

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

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

`getContact(emailAddress)`

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

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

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

// The code below retrieves a contact with the email address
// "john.doe@example.com".
const contact = ContactsApp.getContact('john.doe@example.com');

المعلمات

الاسم	النوع	الوصف
`emailAddress`	`String`	عنوان البريد الإلكتروني لجهة الاتصال

الإرجاع

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

التفويض

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

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

`getContactById(id)`

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

الحصول على جهة الاتصال باستخدام هذا المعرّف

// The code below retrieves the contact with the id
// "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5"
const id =
    'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
const contact = ContactsApp.getContactById(id);

المعلمات

الاسم	النوع	الوصف
`id`	`String`	رقم تعريف جهة الاتصال المطلوب استرجاعها

الإرجاع

Contact: جهة الاتصال المطابقة أو قيمة فارغة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactGroup(name)`

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

تحصل على مجموعة جهات اتصال بالاسم المحدَّد، أو تعرض قيمة فارغة في حال عدم العثور على مجموعة جهات اتصال كهذه.

// The code below returns the contact group with the name "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');

المعلمات

الاسم	النوع	الوصف
`name`	`String`	اسم مجموعة جهات الاتصال المطلوب مطابقتها

الإرجاع

‫ContactGroup: مجموعة جهات الاتصال المطابقة أو القيمة null إذا لم يتم العثور على مجموعة جهات اتصال مطابقة

التفويض

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

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

انظر أيضًا

getContactGroups()

`getContactGroupById(id)`

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

تحصل على مجموعة جهات اتصال باستخدام المعرّف المحدّد، أو تعرض قيمة فارغة في حال عدم العثور على مجموعة جهات اتصال كهذه.

// The code below returns the contact group with the id
// "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"
const id =
    'http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb';
const group = ContactsApp.getContactGroupById(id);

المعلمات

الاسم	النوع	الوصف
`id`	`String`	رقم تعريف مجموعة جهات الاتصال المطلوب مطابقتها

الإرجاع

‫ContactGroup: مجموعة جهات الاتصال المطابقة أو القيمة null إذا لم يتم العثور على مجموعة جهات اتصال مطابقة

انظر أيضًا

getContactGroups()

`getContactGroups()`

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

الحصول على القائمة الكاملة لمجموعات جهات اتصال المستخدم

يمكن أن يكون لدى المستخدم قائمة بجهات الاتصال، وربما قائمة بمجموعات جهات الاتصال أيضًا. يمكن أن تحتوي كل مجموعة جهات اتصال على جهات اتصال. تُرجع هذه الطريقة قائمة بجميع مجموعات جهات الاتصال.

// The retrieves all the contract groups for the user and then logs the group
// name of each contact group.
const groups = ContactsApp.getContactGroups();
for (let i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

الإرجاع

ContactGroup[]: صفيف مجموعات جهات اتصال المستخدم

التفويض

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

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

انظر أيضًا

getContactGroup(name)

`getContacts()`

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

الحصول على جميع جهات اتصال المستخدم

// The code below will retrieve all the user's contacts
const contacts = ContactsApp.getContacts();

الإرجاع

‫Contact[]: صفيف يضم جميع جهات اتصال المستخدم

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByAddress(query)`

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

الحصول على جهات اتصال تتطابق مع عنوان

// The code below returns an array of contacts where the contact's address
// contains "San Francisco'.
const contacts = ContactsApp.getContactsByAddress('San Francisco');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين جهة الاتصال

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByAddress(query, label)`

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

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

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in the Home address field.
const contacts = ContactsApp.getContactsByAddress(
    'San Francisco',
    ContactsApp.Field.HOME_ADDRESS,
);

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين جهة الاتصال
`label`	`Field`	الحقل الذي يتم البحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByAddress(query, label)`

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

الحصول على جهات اتصال تتطابق مع عنوان، تقتصر على تصنيف العنوان المخصّص المحدّد

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in a custom address label (created by the user)
// called "vacation".
const contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين جهات الاتصال باستخدام التصنيف المخصّص للعنوان
`label`	`String`	تصنيف العنوان المخصّص للبحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByCompany(query)`

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

الحصول على جهات اتصال تتطابق مع حقل الشركة

// The code below returns an array of contacts where the contact's company field
// contains "Google".
const contacts = ContactsApp.getContactsByCompany('Google');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في حقل شركة جهة الاتصال

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByCustomField(query, label)`

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

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

يمكن تحديد الحقل المخصّص باستخدام سلسلة أو كأحد قيم ContactsApp.ExtendedField.

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
const contacts = ContactsApp.getContactsByCustomField(
    'tennis',
    'Favorite Sport',
);

المعلمات

الاسم	النوع	الوصف
`query`	`Object`	السلسلة التي يتم البحث عنها في الحقل المخصّص لجهة الاتصال
`label`	`ExtendedField`	الحقل المخصّص للبحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByDate(month, day, label)`

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

الحصول على جهات اتصال تتطابق مع شهر ويوم محدّدَين لحقل عادي معيّن

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    ContactsApp.Field.BIRTHDAY,
);

المعلمات

الاسم	النوع	الوصف
`month`	`Month`	الشهر المطلوب مطابقته، كإحدى القيم من ContactsApp.Month
`day`	`Integer`	اليوم المطلوب مطابقته
`label`	`Field`	الحقل الذي يتم البحث فيه، من ContactsApp.Field

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

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

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

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month, 19 for the day, and 1950 for the year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    1950,
    ContactsApp.Field.BIRTHDAY,
);

المعلمات

الاسم	النوع	الوصف
`month`	`Month`	الشهر المطلوب مطابقته، كإحدى القيم من ContactsApp.Month
`day`	`Integer`	اليوم المطلوب مطابقته
`year`	`Integer`	السنة المطلوب مطابقتها، ويمكن أن تكون فارغة
`label`	`Field`	الحقل الذي يتم البحث فيه، من ContactsApp.Field

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

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

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

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month, 19 for the day, and 2011 for the
// year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    2011,
    'Start Date',
);

المعلمات

الاسم	النوع	الوصف
`month`	`Month`	الشهر المطلوب مطابقته، كإحدى القيم من ContactsApp.Month
`day`	`Integer`	اليوم المطلوب مطابقته
`year`	`Integer`	السنة المطلوب مطابقتها، ويمكن أن تكون فارغة
`label`	`String`	الحقل المخصّص للبحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByDate(month, day, label)`

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

الحصول على جهات اتصال تتطابق مع شهر ويوم محدّدَين في حقل مخصّص معيّن

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    'Start Date',
);

المعلمات

الاسم	النوع	الوصف
`month`	`Month`	الشهر المطلوب مطابقته، كإحدى القيم من ContactsApp.Month
`day`	`Integer`	اليوم المطلوب مطابقته
`label`	`String`	الحقل المخصّص للبحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByEmailAddress(query)`

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

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

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com'.
const contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين البريد الإلكتروني لجهات الاتصال

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

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

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

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in the Home email field.
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    ContactsApp.Field.HOME_EMAIL,
);

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين البريد الإلكتروني لجهات الاتصال
`label`	`Field`	الحقل الذي يتم البحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

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

الحصول على جهات اتصال تتطابق مع عنوان بريد إلكتروني، يقتصر على تصنيف عنوان البريد الإلكتروني المخصّص المحدّد

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in a custom email address label (created by
// the user) called "alternate".
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    'alternate',
);

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين البريد الإلكتروني المخصّصة للتواصل باستخدام التصنيف المخصّص لعنوان البريد الإلكتروني
`label`	`String`	تصنيف عنوان البريد الإلكتروني المخصّص للبحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByGroup(group)`

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

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

// The code below returns an array of contacts in the ContactGroup with the name
// "Work Friends".
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = ContactsApp.getContactsByGroup(group);

المعلمات

الاسم	النوع	الوصف
`group`	`ContactGroup`	مجموعة جهات الاتصال

الإرجاع

Contact[]: صفيف جهات الاتصال في المجموعة المحدّدة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByIM(query)`

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

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

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in any instant messaging field.
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين المراسلة الفورية لجهة الاتصال

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByIM(query, label)`

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

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

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in the AIM instant messaging
// field.
const contacts = ContactsApp.getContactsByIM(
    'ChatWithJohnDoe',
    ContactsApp.Field.AIM,
);

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين المراسلة الفورية لجهة الاتصال
`label`	`Field`	الحقل الذي يتم البحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByIM(query, label)`

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

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

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in a custom instant messaging
// label (created by the user) called "eBuddy".
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين المراسلة الفورية لجهة الاتصال باستخدام تصنيف المراسلة الفورية المخصّص المحدّد
`label`	`String`	تصنيف الرسائل الفورية المخصّص للبحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByJobTitle(query)`

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

الحصول على جهات اتصال تتطابق مع حقل المسمى الوظيفي

// The code below returns an array of contacts where the contact's job title
// field contains "Product Manager".
const contacts = ContactsApp.getContactsByJobTitle('Product Manager');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في حقل المسمى الوظيفي لجهة الاتصال

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByName(query)`

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

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

// The code below returns an array of contacts where the contact name contains
// "John"
const contacts = ContactsApp.getContactsByName('John');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في أسماء جهات الاتصال

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByName(query, label)`

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

الحصول على جهات اتصال تتطابق مع اسم معيّن، تقتصر على حقل معيّن

// The code below returns an array of contacts where the contact name contains
// "John" in the Given Name field.
const contacts = ContactsApp.getContactsByName(
    'John',
    ContactsApp.Field.GIVEN_NAME,
);

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في أسماء جهات الاتصال
`label`	`Field`	الحقل الذي يتم البحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByNotes(query)`

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

الحصول على جهات الاتصال التي تتطابق مع حقل "الملاحظات"

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
const contacts = ContactsApp.getContactsByNotes('sent birthday card');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في حقل ملاحظات جهة الاتصال

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByPhone(query)`

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

الحصول على جهات اتصال تتطابق مع رقم هاتف

ستؤدي هذه الطريقة إلى توسيع أرقام الهواتف التي تحتوي على أحرف، لذا إذا كنت تبحث عن ‎212-555-CODE وكانت لديك ‎212-555-2633 في جهات الاتصال أو العكس، ستعثر الطريقة على جهة الاتصال المناسبة.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234' in any phone number field.
const contacts = ContactsApp.getContactsByPhone('212-555-1234');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في أرقام هواتف جهة الاتصال

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByPhone(query, label)`

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

الحصول على جهات اتصال تتطابق مع رقم هاتف، يقتصر على حقل معيّن

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in the Home phone number field.
const contacts = ContactsApp.getContactsByPhone(
    '212-555-1234',
    ContactsApp.Field.HOME_PHONE,
);

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في أرقام هواتف جهة الاتصال
`label`	`Field`	الحقل الذي يتم البحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByPhone(query, label)`

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

الحصول على جهات اتصال تتطابق مع رقم هاتف، تقتصر على تصنيف رقم الهاتف المخصّص المحدّد

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in a custom phone number label (created by the user)
// called "alternate".
const contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في أرقام هواتف جهة الاتصال باستخدام تصنيف رقم الهاتف المخصّص المُحدَّد
`label`	`String`	تصنيف رقم الهاتف المخصّص للبحث ضمنه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByUrl(query)`

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

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

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com' in any URL field.
const contacts = ContactsApp.getContactsByUrl('www.example.com');

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين URL الخاصة بجهة الاتصال

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByUrl(query, label)`

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

الحصول على جهات اتصال تتطابق مع عنوان URL، تقتصر على حقل معيّن

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in the Work URL field.
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    ContactsApp.Field.WORK_WEBSITE,
);

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين URL الخاصة بجهة الاتصال
`label`	`Field`	الحقل الذي يتم البحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)

`getContactsByUrl(query, label)`

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

الحصول على جهات اتصال تتطابق مع عنوان URL، يقتصر على تصنيف عنوان URL المخصّص المحدّد

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in a custom URL label (created by the user) called
// "alternate work".
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    'alternate work',
);

المعلمات

الاسم	النوع	الوصف
`query`	`String`	السلسلة التي يتم البحث عنها في عناوين URL الخاصة بجهة الاتصال باستخدام تصنيف عنوان URL المخصّص المحدّد
`label`	`String`	تصنيف عنوان URL المخصّص للبحث فيه

الإرجاع

Contact[]: صفيف من جهات الاتصال المطابقة

التفويض

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

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

انظر أيضًا

getContact(emailAddress)