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 الذي تتوافق معه العضوية. في حال تمت المصادقة كمستخدم في تطبيق Chat، ستتم تعبئة المستخدم name وtype.

groupMember

object (Group)

"مجموعة Google" المتوافقة مع العضوية.

MembershipState

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

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

MembershipRole

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

عمليات التعداد
MEMBERSHIP_ROLE_UNSPECIFIED القيمة التلقائية. بالنسبة إلى users: هذا الشخص ليس عضوًا في المساحة، ولكن يمكن دعوته. بالنسبة إلى Google Groups: يتم دائمًا منح هذا الدور لهم (قد يتم استخدام قيم التعداد الأخرى في المستقبل).
ROLE_MEMBER عضو في المساحة يمتلك المستخدم الأذونات الأساسية، مثل إرسال الرسائل إلى المساحة. في المحادثات بين شخصين والمحادثات الجماعية بدون اسم، يحصل جميع المستخدمين على هذا الدور.
ROLE_MANAGER مدير مساحة يمتلك المستخدم جميع الأذونات الأساسية بالإضافة إلى الأذونات الإدارية التي تتيح له إدارة المساحة، مثل إضافة الأعضاء أو إزالتهم. لا تتوفَّر هذه الميزة إلّا في SpaceType.SPACE.

مجموعة

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

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

string

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

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

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

الطُرق

create

إنشاء اشتراك في تطبيق Chat للاتصال أو لمستخدم أو مجموعة Google

delete

يؤدي هذا الإجراء إلى حذف الاشتراك.

get

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

list

يسرد العضوية في مساحة.

patch

تعديل اشتراك