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

Class ContactsApp

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

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

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

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

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

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
`createContact(givenName, familyName, email)`	`Contact`	إنشاء جهة اتصال جديدة
`createContactGroup(name)`	`ContactGroup`	ينشئ مجموعة جهات اتصال بالاسم الذي تم إدخاله.
`deleteContact(contact)`	`void`	حذف جهة الاتصال
`deleteContactGroup(group)`	`void`	حذف مجموعة جهات الاتصال
`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".
var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');

المَعلمات

الاسم	Type	الوصف
`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"
var group = ContactsApp.createContactGroup("Work Friends");

المَعلمات

الاسم	Type	الوصف
`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.
var contact = ContactsApp.getContact('john.doe@example.com');
ContactsApp.deleteContact(contact);

المَعلمات

الاسم	Type	الوصف
`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"
var group = ContactsApp.getContactGroup("Work Friends");
ContactsApp.deleteContactGroup(group);

المَعلمات

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

التفويض

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

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

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

createContactGroup(name)

`findByEmailAddress(email)`

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

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

المَعلمات

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

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

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

التفويض

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

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

`findContactGroup(name)`

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

للبحث عن مجموعة جهات اتصال بالاسم الذي تم إدخاله.

المَعلمات

الاسم	Type	الوصف
`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".
var contact = ContactsApp.getContact('john.doe@example.com');

المَعلمات

الاسم	Type	الوصف
`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"
var id = 'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
var contact = ContactApp.getContactById(id);

المَعلمات

الاسم	Type	الوصف
`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"
var group  = ContactsApp.getContactGroup('Work Friends');

المَعلمات

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

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

ContactGroup - مجموعة جهات الاتصال المطابقة أو فارغة في حال عدم العثور على مجموعة جهات اتصال مطابقة

التفويض

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

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"
var id = "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb";
var group  = ContactsApp.getContactGroupById(id);

المَعلمات

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

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

ContactGroup - مجموعة جهات الاتصال المطابقة أو فارغة في حال عدم العثور على مجموعة جهات اتصال مطابقة

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

getContactGroups()

`getContactGroups()`

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

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

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

// The retrieves all the contract groups for the user and then logs the group name of each
// contact group.
var groups  = ContactsApp.getContactGroups();
for (var 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
var 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'.
var contacts = ContactsApp.getContactsByAddress('San Francisco');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByAddress('San Francisco',
                                                ContactsApp.Field.HOME_ADDRESS);

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByCompany('Google');

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByCustomField('tennis', 'Favorite Sport');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19,
                                              ContactsApp.Field.BIRTHDAY);

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 1950,
                                             ContactsApp.Field.BIRTHDAY);

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 2011, 'Start Date');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 'Start Date');

المَعلمات

الاسم	Type	الوصف
`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'.
var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com',
                                                     ContactsApp.Field.HOME_EMAIL);

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com', 'alternate');

المَعلمات

الاسم	Type	الوصف
`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".
var group  = ContactsApp.getContactGroup('Work Friends');
var contacts = ContactsApp.getContactsByGroup(group);

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe',
                                            ContactsApp.Field.AIM);

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByJobTitle('Product Manager');

المَعلمات

الاسم	Type	الوصف
`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"
var contacts = ContactsApp.getContactsByName('John');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByName('John', ContactsApp.Field.GIVEN_NAME);

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByNotes('sent birthday card');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByPhone('212-555-1234');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByPhone('212-555-1234',
                                              ContactsApp.Field.HOME_PHONE);

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByUrl('www.example.com');

المَعلمات

الاسم	Type	الوصف
`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.
var contacts = ContactsApp.getContactsByUrl('www.example.com',
                                            ContactsApp.Field.WORK_WEBSITE);

المَعلمات

الاسم	Type	الوصف
`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".
var contacts = ContactsApp.getContactsByUrl('www.example.com', 'alternate work');

المَعلمات

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

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

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

التفويض

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

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

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

getContact(emailAddress)