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

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