REST Resource: spaces.members

المورد: الاشتراك

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

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

  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
}
الحقول
name

string

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

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

enum (MembershipState)

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

enum (MembershipRole)

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

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

string (Timestamp format)

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

string (Timestamp format)

اختياريّ. غير قابل للتغيير وقت حذف الاشتراك، مثل وقت مغادرة أحد الأعضاء لمساحة أو إزالته منها لا يتم عرض هذا الحقل إلا عند استخدامه لاستيراد الاشتراكات السابقة في مساحات وضع الاستيراد.
affiliation

enum (Affiliation)

النتائج فقط. علاقة المستخدم بمؤسسة Workspace التي تملك المساحة في المساحات التي تملكها حسابات المستهلكين، يكون ارتباط جميع الأعضاء EXTERNAL.
حقل الربط memberType العضو المرتبط بهذا الاشتراك قد يتم دعم أنواع أخرى من الأعضاء في المستقبل. لا يمكن أن يكون memberType إلا أحد الخيارات التالية:
member

object (User)

اختياريّ. مستخدم 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

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

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

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

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

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

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

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

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

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

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

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

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

مجموعة

"مجموعة Google" في Google Chat

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

string

اسم المورِد لـ "مجموعة Google"

يمثّل مجموعة في Cloud Identity Groups API.

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

الارتباط

يمثّل ارتباط المستخدم بمؤسسة Google Workspace التي تملك المساحة قد تتم إضافة المزيد من القيم إلى هذا التعداد في المستقبل.

عمليات التعداد
AFFILIATION_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
INTERNAL حساب تديره مؤسسة Google Workspace نفسها التي تملك المساحة
EXTERNAL حساب خارجي عن مؤسسة Google Workspace التي تملك المساحة (مثل حساب مستهلك أو حساب تديره مؤسسة Workspace مختلفة)
MANAGED_EXTERNAL حساب تديره مؤسسة Workspace التي تملك المساحة، ولكن تم توفيره لمستخدم خارجي عن المؤسسة (مثل مستخدم ضيف) لمعرفة المزيد عن الضيوف، يُرجى الانتقال إلى https://support.google.com/chat/answer/16997417.

الطُرق

create

 ينشئ اشتراكًا لتطبيق Chat الذي يجري الاتصال أو لمستخدم أو "مجموعة Google"

delete

 يحذف اشتراكًا

get

 يعرض تفاصيل حول اشتراك

list

 يعرض الاشتراكات في مساحة

patch

 يعدّل اشتراكًا