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

 تعديل اشتراك