Class ContactGroup

ContactGroup

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

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

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

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
addContact(contact)	ContactGroup	يضيف جهة الاتصال المحددة إلى هذه المجموعة.
deleteGroup()	void	حذف مجموعة جهات الاتصال هذه
getContacts()	Contact[]	جلب جميع جهات الاتصال في مجموعة جهات الاتصال هذه
getGroupName()	String	تعرض اسم هذه المجموعة.
getId()	String	الحصول على رقم تعريف مجموعة جهات الاتصال هذه.
getName()	String	الحصول على اسم مجموعة جهات الاتصال هذه.
isSystemGroup()	Boolean	الحصول على قيمة منطقية لتحديد ما إذا كانت مجموعة جهات الاتصال هذه مجموعة نظام (غير قابلة للحذف) أم لا.
removeContact(contact)	ContactGroup	إزالة جهة الاتصال المحددة من هذه المجموعة
setGroupName(name)	void	تعيّن اسم هذه المجموعة.
setName(name)	ContactGroup	لضبط اسم مجموعة جهات الاتصال هذه.

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

addContact(contact)

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

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

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

المَعلمات

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

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

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

التفويض

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

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

---

getName()

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

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

// The code below creates a new contact group and then retrieves its name
var group = ContactsApp.createContactGroup('Work Friends');
var 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.
var myGroup = ContactsApp.getContactGroup('Work Friends');
var 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
var contacts = ContactsApp.getContactsByName('John Doe');
var group = ContactsApp.getContactGroup('Work Friends');
for (var i in contacts) {
  group.removeContact(contacts[i]);
}

المَعلمات

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

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

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

التفويض

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

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

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

• addContact(contact)

---

setGroupName(name)

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

تعيّن اسم هذه المجموعة.

المَعلمات

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

المَعلمات

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

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

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

التفويض

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

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

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

• getName()