REST Resource: spaces.members

المصدر: العضوية

تمثّل هذه السمة علاقة العضوية في Google Chat، مثل ما إذا تمت دعوة مستخدم أو تطبيق Chat إلى مساحة أو كان جزءًا منها أو غير متوفّر فيها.

تمثيل JSON 
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,

  // Union field memberType can be only one of the following:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
  // End of list of possible types for union field memberType.
}
الحقول
name

string

المعرّف تمثّل هذه السمة اسم المورد الخاص بالاشتراك، والذي يحدّده الخادم.

التنسيق: spaces/{space}/members/{member}
state

enum (MembershipState)

النتائج فقط. حالة الاشتراك
role

enum (MembershipRole)

اختيارية: دور المستخدم في مساحة Chat، والذي يحدّد الإجراءات المسموح له بتنفيذها في المساحة

لا يمكن استخدام هذا الحقل كإدخال إلا في members.patch.
createTime

string (Timestamp format)

اختيارية: غير قابل للتغيير وقت إنشاء العضوية، مثل وقت انضمام عضو إلى مساحة أو تلقّيه دعوة للانضمام إليها هذا الحقل مخصّص للإخراج فقط، باستثناء استخدامه لاستيراد العضويات السابقة في مساحات وضع الاستيراد.
deleteTime

string (Timestamp format)

اختيارية: غير قابل للتغيير وقت حذف العضوية، مثلاً عندما غادر عضو مساحة أو تمت إزالته منها هذا الحقل مخصّص للإخراج فقط، باستثناء استخدامه لاستيراد العضويات السابقة في مساحات وضع الاستيراد.
حقل الدمج memberType تمثّل هذه السمة العضو المرتبط بهذه العضوية. قد تتم إتاحة أنواع أخرى من الأعضاء في المستقبل. يمكن أن تكون memberType إحدى القيم التالية فقط:
member

object (User)

اختيارية: مستخدم Google Chat أو تطبيق Google Chat الذي يتوافق معه الاشتراك إذا كان تطبيق Chat يصادق على المستخدم، ستملأ النتيجة المستخدم name وtype.
groupMember

object (Group)

اختيارية: مجموعة Google التي تتوافق مع العضوية

تتطلّب قراءة العضويات في "مجموعات Google" أو تعديلها مصادقة المستخدم.

MembershipState

تحدّد هذه السمة علاقة العضو بالمساحة. قد نتيح استخدام هذه الميزة في ولايات أخرى في المستقبل.

عمليات التعداد
MEMBERSHIP_STATE_UNSPECIFIED القيمة التلقائية لا تستخدِمها.
JOINED تتم إضافة المستخدم إلى المساحة، ويمكنه المشاركة فيها.
INVITED تمت دعوة المستخدم للانضمام إلى المساحة، ولكنّه لم ينضم إليها.
NOT_A_MEMBER لا ينتمي المستخدم إلى المساحة وليس لديه دعوة معلّقة للانضمام إليها.

MembershipRole

تمثّل هذه السمة الإجراءات المسموح بها للمستخدم في مساحة Chat. قد تتم إضافة المزيد من قيم التعداد في المستقبل.

عمليات التعداد
MEMBERSHIP_ROLE_UNSPECIFIED القيمة التلقائية بالنسبة إلى users: هذا المستخدم ليس عضوًا في المساحة، ولكن يمكن دعوته. بالنسبة إلى Google Groups: يتم دائمًا تعيين هذا الدور له (قد يتم استخدام قيم تعداد أخرى في المستقبل).
ROLE_MEMBER

عضو في المساحة في واجهة مستخدم Chat، يُطلق على هذا الدور اسم "عضو".

لدى المستخدم أذونات أساسية، مثل إرسال رسائل إلى المساحة. يمكن للمدراء والمالكين منح الأعضاء أذونات إضافية في مساحة، بما في ذلك:

  • إضافة أعضاء أو إزالتهم
  • تعديل تفاصيل المساحة
  • فعِّل السجلّ أو أوقِفه.
  • الإشارة إلى جميع المشاركين في المساحة باستخدام @all
  • إدارة تطبيقات Chat وخطافات الويب المثبَّتة في المساحة

في الرسائل المباشرة والمحادثات الجماعية بدون اسم، يتم منح هذا الدور لجميع المشاركين.
ROLE_MANAGER

مالك مساحة في واجهة مستخدم "المحادثة"، يُطلق على هذا الدور اسم "المالك".

لدى المستخدم مجموعة كاملة من أذونات المساحة لإدارتها، بما في ذلك:

  • تغيير دور الأعضاء الآخرين في المساحة إلى عضو أو مدير أو مالك
  • احذف المساحة.

لا تتوفّر هذه الميزة إلا في SpaceType.SPACE (المساحات المُسمّاة).

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مزيد من المعلومات عن دور مالك المساحة أو مديرها.
ROLE_ASSISTANT_MANAGER

مدير مساحة في واجهة مستخدم "المحادثة"، يُطلق على هذا الدور اسم "مدير".

يملك المستخدم جميع الأذونات الأساسية في ROLE_MEMBER، ويمكن للمالك منحه مجموعة فرعية من أذونات المشرف. بشكل تلقائي، يحصل المدراء على جميع أذونات المالك باستثناء القدرة على:

  • احذف المساحة.
  • اختيار عضو آخر ليكون مالك المساحة
  • تغيير دور المالك

تتضمّن أذونات المدراء تلقائيًا ما يلي، على سبيل المثال لا الحصر:

  • منح عضو آخر دور مدير
  • حذف الرسائل في المساحة
  • إدارة أذونات المساحة
  • تلقّي إشعارات بطلبات الانضمام إلى المساحة إذا كان لدى المدير إذن "إدارة الأعضاء" في إعدادات المساحة
  • جعل مساحة قابلة للاكتشاف

لا تتوفّر هذه الميزة إلا في SpaceType.SPACE (المساحات المُسمّاة).

لمزيد من المعلومات، يُرجى الاطّلاع على إدارة إعدادات المساحة.

مجموعة

مجموعة Google في Google Chat

تمثيل JSON 
{
  "name": string
}
الحقول
name

string

اسم المورد لمجموعة Google

تمثّل هذه السمة مجموعة في Cloud Identity Groups API.

التنسيق: groups/{group}

الطُرق

create

 تُنشئ هذه السمة عضوية لتطبيق الاتصال في Chat أو لمستخدم أو لمجموعة Google.

delete

 تحذف هذه الطريقة عضوية.

get

 تعرض هذه الطريقة تفاصيل حول عضوية.

list

 تعرض هذه الطريقة عضويات المستخدم في مساحة.

patch

 تعدّل هذه الطريقة اشتراكًا.