REST Resource: spaces.members

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

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 يصادق على هوية المستخدم، لن يتم ملء سوى الحقلَين user 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

 تعديل اشتراك