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.

التنسيق: مجموعات/{group}

الطُرق

create

أنشأ عضوية بشرية أو عضوية في تطبيق لتطبيق الاتصال.

delete

حذف عضوية

get

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

list

يسرد الاشتراكات في مساحة.

patch

لتعديل اشتراك