REST Resource: spaces.members

منبع: عضویت

نشان دهنده یک رابطه عضویت در Google 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 )

اختیاری. نقش کاربر در فضای چت، که اقدامات مجاز آنها را در فضا تعیین می کند.

این فیلد فقط می تواند به عنوان ورودی در members.patch استفاده شود.

createTime

string ( Timestamp format)

اختیاری. تغییرناپذیر. زمان ایجاد عضویت، مانند زمانی که یک عضو به یک فضا ملحق شد یا برای پیوستن به آن دعوت شد. این فیلد فقط خروجی است، مگر زمانی که برای وارد کردن عضویت های تاریخی در فضاهای حالت واردات استفاده می شود.

deleteTime

string ( Timestamp format)

اختیاری. تغییرناپذیر. زمان حذف عضویت، مانند زمانی که یک عضو از یک فاصله خارج شد یا از آن حذف شد. این فیلد فقط خروجی است، مگر زمانی که برای وارد کردن عضویت های تاریخی در فضاهای حالت واردات استفاده می شود.

memberType فیلد اتحادیه عضو مرتبط با این عضویت سایر انواع اعضا ممکن است در آینده پشتیبانی شوند. memberType تنها می تواند یکی از موارد زیر باشد:
member

object ( User )

اختیاری. کاربر یا برنامه Google Chat که عضویت با آن مطابقت دارد. اگر برنامه چت شما به عنوان کاربر احراز هویت شود ، خروجی name و type کاربر را پر می کند.

groupMember

object ( Group )

اختیاری. گروه Google که عضویت با آن مطابقت دارد.

خواندن یا تغییر عضویت در Google Groups به احراز هویت کاربر نیاز دارد.

کشور عضویت

رابطه اعضا با یک فضا را مشخص می کند. سایر کشورهای عضو ممکن است در آینده مورد حمایت قرار گیرند.

Enums
MEMBERSHIP_STATE_UNSPECIFIED مقدار پیش فرض استفاده نکنید.
JOINED کاربر به فضا اضافه می شود و می تواند در فضا شرکت کند.
INVITED کاربر برای پیوستن به فضا دعوت شده است، اما به آن نپیوسته است.
NOT_A_MEMBER کاربر به فضا تعلق ندارد و دعوتنامه معلقی برای پیوستن به فضا ندارد.

نقش عضویت

نشان دهنده اقدامات مجاز کاربر در فضای چت است. مقادیر enum بیشتری ممکن است در آینده اضافه شود.

Enums
MEMBERSHIP_ROLE_UNSPECIFIED مقدار پیش فرض برای users : آنها عضو فضا نیستند، اما می توانند دعوت شوند. برای Google Groups : همیشه این نقش به آن‌ها اختصاص داده می‌شود (ممکن است در آینده از مقادیر enum دیگری استفاده شود).
ROLE_MEMBER

عضوی از فضا در رابط کاربری چت به این نقش Member گفته می شود.

کاربر دارای مجوزهای اولیه مانند ارسال پیام به فضا است. مدیران و مالکان می توانند مجوزهای اضافی را در یک فضا به اعضا اعطا کنند، از جمله:

  • اعضا را اضافه یا حذف کنید.
  • جزئیات فضا را تغییر دهید
  • تاریخچه را روشن یا خاموش کنید.
  • همه افراد را در فضا با @all ذکر کنید.
  • برنامه های چت و وبکهک های نصب شده در فضا را مدیریت کنید.

در پیام های مستقیم و گفتگوهای گروهی بدون نام، همه این نقش را دارند.

ROLE_MANAGER

صاحب فضا در رابط کاربری چت این نقش Owner نامیده می شود.

کاربر مجموعه کاملی از مجوزهای فضا را برای مدیریت فضا دارد، از جمله:

  • نقش سایر اعضا در فضا را به عضو، مدیر یا مالک تغییر دهید.
  • فضا را حذف کنید.

فقط در SpaceType.SPACE (فضاهای نامگذاری شده) پشتیبانی می شود.

برای کسب اطلاعات بیشتر، درباره نقش خود به عنوان مالک یا مدیر فضا بیشتر بدانید.

گروه

یک گروه گوگل در چت گوگل.

نمایندگی JSON 
{
  "name": string
}
فیلدها
name

string

نام منبع برای یک گروه Google.

یک گروه را در Cloud Identity Groups API نشان می دهد.

قالب: گروه/{گروه}

روش ها

create

 یک عضویت برای برنامه چت تماس گیرنده، یک کاربر یا یک گروه Google ایجاد می کند.

delete

 عضویت را حذف می کند.

get

 جزئیات عضویت را برمی‌گرداند.

list

 عضویت ها را در یک فضا فهرست می کند.

patch

 عضویت را به روز می کند.