Groups Service

مجموعات Google

تسمح هذه الخدمة للبرامج النصية بالوصول إلى "مجموعات Google". ويمكن استخدامه للاستعلام عن معلومات، مثل عنوان البريد الإلكتروني للمجموعة أو قائمة المجموعات التي يكون المستخدم عضوًا مباشرًا فيها. في ما يلي مثال يوضّح عدد المجموعات التي ينتمي إليها المستخدم الحالي:

var groups = GroupsApp.getGroups();
Logger.log('You are a member of %s Google Groups.', groups.length);

الدروس

الاسم	وصف قصير
Group	عنصر مجموعة يمكن الاستعلام عن أعضائه وأدوارهم داخل المجموعة.
GroupsApp	يتيح هذا الصف الوصول إلى معلومات "مجموعات Google".
Role	الأدوار المحتملة للمستخدم داخل المجموعة، مثل المالك أو العضو العادي

Group

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
getEmail()	String	تعرض هذه السمة عنوان البريد الإلكتروني للمجموعة.
getGroups()	Group[]	يسترد هذا الإجراء المجموعات الفرعية المباشرة للمجموعة.
getRole(email)	Role	يسترد هذا الإجراء دور المستخدم في سياق المجموعة.
getRole(user)	Role	يسترد هذا الإجراء دور المستخدم في سياق المجموعة.
getRoles(users)	Role[]	تعرض هذه الطريقة أدوار المستخدمين في سياق المجموعة.
getUsers()	User[]	تعرض هذه الطريقة الأعضاء المباشرين والمحظورين في المجموعة الذين لديهم حساب Google معروف ومطابق.
hasGroup(group)	Boolean	تختبر هذه السمة ما إذا كانت المجموعة عضوًا مباشرًا في هذه المجموعة.
hasGroup(email)	Boolean	تختبر هذه السمة ما إذا كانت المجموعة عضوًا مباشرًا في هذه المجموعة.
hasUser(email)	Boolean	تختبر هذه السمة ما إذا كان المستخدم عضوًا مباشرًا في المجموعة.
hasUser(user)	Boolean	تختبر هذه السمة ما إذا كان المستخدم عضوًا مباشرًا في المجموعة.

GroupsApp

الخصائص

الموقع	النوع	الوصف
Role	Role

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
getGroupByEmail(email)	Group	تعرض هذه الطريقة المجموعة التي لها عنوان البريد الإلكتروني المحدّد.
getGroups()	Group[]	تعرض هذه الطريقة جميع المجموعات التي أنت عضو مباشر فيها (أو عضو في انتظار الموافقة).

Role

الخصائص

الموقع	النوع	الوصف
OWNER	Enum	مالك المجموعة
MANAGER	Enum	مدير المجموعة
MEMBER	Enum	مستخدم عضو في هذه المجموعة وليس مالكًا أو مديرًا.
INVITED	Enum	مستخدم تمت دعوته للانضمام إلى مجموعة من قِبل مالك المجموعة أو مديرها، ولكنّه لم يقبل الدعوة بعد.
PENDING	Enum	مستخدم طلب الانضمام إلى مجموعة ولكن لم يوافق عليه بعد مالك أو مدير.
BANNED	Enum	مستخدم تم حظره من مجموعة ولا يمكنه محاولة الانضمام إليها