Class ContactGroup

مجموعةالتواصل

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

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

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

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
addContact(contact)	ContactGroup	تُضيف جهة الاتصال المحدّدة إلى هذه المجموعة. // The code below creates a new contact and adds it to the "Work Friends" // contact group const contact = ContactsApp.createContact( 'John', 'Doe', '[e-mail]', ); const group = ContactsApp.getContactGroup('Work Friends'); group.addContact(contact);
deleteGroup()	void	يؤدي هذا الإجراء إلى حذف مجموعة جهات الاتصال هذه.
getContacts()	Contact[]	الحصول على جميع جهات الاتصال في مجموعة جهات الاتصال هذه
getGroupName()	String	عرض اسم هذه المجموعة
getId()	String	تحصل على رقم تعريف مجموعة جهات الاتصال هذه.
getName()	String	تحصل على اسم مجموعة جهات الاتصال هذه.
isSystemGroup()	Boolean	تحصل على قيمة منطقية لتحديد ما إذا كانت مجموعة جهات الاتصال هذه هي مجموعة نظام (لا يمكن حذفها) أو لا.
removeContact(contact)	ContactGroup	إزالة جهة الاتصال المحدّدة من هذه المجموعة // The code below retrieves all the contacts named "John Doe' and removes them // from the "Work Friends" contact group const contacts = ContactsApp.getContactsByName('John Doe'); const group = ContactsApp.getContactGroup('Work Friends'); for (const i in contacts) { group.removeContact(contacts[i]); }
setGroupName(name)	void	لضبط اسم هذه المجموعة.
setName(name)	ContactGroup	لضبط اسم مجموعة جهات الاتصال هذه.

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

addContact(contact)

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

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

// The code below creates a new contact and adds it to the "Work Friends"
// contact group
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    '[e-mail]',
);
const group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);

المعلمات

الاسم	النوع	الوصف
contact	Contact	جهة الاتصال المطلوب إضافتها إلى المجموعة

الإرجاع

ContactGroup - مجموعة جهات الاتصال هذه

التفويض

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

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

انظر أيضًا

• removeContact(contact)

---

deleteGroup()

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

يؤدي هذا الإجراء إلى حذف مجموعة جهات الاتصال هذه.

يؤدي هذا الإجراء إلى حذف المجموعات غير التابعة للنظام فقط، ولا يمكن حذف مجموعات النظام.

// The code below retrieves a contact group named "Work Friends" and deletes it
const group = ContactsApp.getContactGroup('Work Friends');
group.deleteGroup();

التفويض

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

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

انظر أيضًا

• isSystemGroup()

---

getContacts()

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

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

// The code below retrieves all the contacts in the group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = group.getContacts();

الإرجاع

Contact[] - جهات الاتصال في هذه المجموعة

التفويض

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

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

---

getGroupName()

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

عرض اسم هذه المجموعة

الإرجاع

String: اسم هذه المجموعة

التفويض

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

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

---

getId()

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

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

// The code below retrieves a contact group named "Work Friends" and gets its id
const group = ContactsApp.getContactGroup('Work Friends');
const id = group.getId();

الإرجاع

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

التفويض

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

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

---

getName()

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

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

// The code below creates a new contact group and then retrieves its name
const group = ContactsApp.createContactGroup('Work Friends');
const name = group.getName();

الإرجاع

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

التفويض

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

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

انظر أيضًا

• setName(name)

---

isSystemGroup()

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

تحصل على قيمة منطقية لتحديد ما إذا كانت مجموعة جهات الاتصال هذه هي مجموعة نظام (لا يمكن حذفها) أو لا.

مجموعات الأنظمة هي مجموعة من المجموعات المحدّدة مسبقًا في "جهات اتصال Google"، مثل " جهات اتصالي" و"العائلة" و"الزملاء" وما إلى ذلك. يحتوي اسم مجموعة النظام عادةً على الكلمات "مجموعة النظام".

// The code below retrieves two contact groups, then logs whether or not
// each is a system group.
const myGroup = ContactsApp.getContactGroup('Work Friends');
const systemGroup = ContactsApp.getContactGroup('System Group: Coworkers');
Logger.log(myGroup.isSystemGroup());      // Returns false, if the group exists.
Logger.log(systemGroup.isSystemGroup());  // Returns true.

الإرجاع

‫Boolean - ما إذا كانت مجموعة جهات الاتصال هذه هي مجموعة نظام أم لا

التفويض

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

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

---

removeContact(contact)

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

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

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

المعلمات

الاسم	النوع	الوصف
contact	Contact	جهة الاتصال المطلوب إزالتها من المجموعة

الإرجاع

ContactGroup - مجموعة جهات الاتصال هذه

التفويض

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

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

انظر أيضًا

• addContact(contact)

---

setGroupName(name)

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

لضبط اسم هذه المجموعة.

المعلمات

الاسم	النوع	الوصف
name	String	الاسم المطلوب ضبطه لهذه المجموعة

التفويض

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

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

---

setName(name)

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

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

// The code below retrieves the contact group named "Work Friends" and renames
// it to "Work Buddies"
const group = ContactsApp.getContactGroup('Work Friends');
group.setName('Work Buddies');

المعلمات

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

الإرجاع

ContactGroup - مجموعة جهات الاتصال هذه

التفويض

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

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

انظر أيضًا

• getName()