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.
تمثّل هذه السمة العضو المرتبط بهذه العضوية. قد تتم إتاحة أنواع أخرى من الأعضاء في المستقبل. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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

مالك مساحة في واجهة مستخدم 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

 تعديل اشتراك