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 التي تتوافق معها العضوية

تتطلّب قراءة العضويات في "مجموعات 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

 تعديل اشتراك