- درخواست HTTP
- پارامترهای مسیر
- پارامترهای پرس و جو
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- آن را امتحان کنید!
یک عضویت انسانی یا عضویت برنامه برای برنامه تماس ایجاد می کند. ایجاد عضویت برای سایر برنامه ها پشتیبانی نمی شود. برای مثال، دعوت کردن یا افزودن یک کاربر یا برنامه Google Chat را به یک فضا ببینید. هنگام ایجاد عضویت، اگر خطمشی پذیرش خودکار عضو مشخصشده خاموش باشد، دعوت میشود و باید قبل از پیوستن، دعوت فضایی را بپذیرد. در غیر این صورت، ایجاد عضویت، عضو را مستقیماً به فضای مشخص شده اضافه می کند. نیاز به احراز هویت کاربر دارد.
برای تعیین عضوی که باید اضافه شود، membership.member.name
را برای عضو انسانی یا برنامه تنظیم کنید، یا membership.group_member.name
را برای عضو گروه تنظیم کنید.
برای افزودن برنامه تماس به یک فاصله یا پیام مستقیم بین دو کاربر انسانی، از
users/app
استفاده کنید. نمیتوان برنامههای دیگر را به فضا اضافه کرد.برای افزودن یک کاربر انسانی، از
users/{user}
استفاده کنید، جایی که{user}
میتواند آدرس ایمیل کاربر باشد. برای کاربران در همان سازمان Workspace{user}
همچنین میتواندid
شخص از People API یاid
کاربر در Directory API باشد. برای مثال، اگر شناسه نمایه افراد API People برایuser@example.com
123456789
باشد، میتوانید با تنظیمmembership.member.name
بهusers/user@example.com
یاusers/123456789
کاربر را به فضا اضافه کنید.برای افزودن یا دعوت یک گروه Google در یک فضای نامگذاری شده، از
groups/{group}
استفاده کنید، جایی که{group}
id
گروه از Cloud Identity Groups API است. برای مثال، میتوانید از API جستجوی Cloud Identity Groups برای بازیابی شناسه123456789
برای ایمیل گروهیgroup@example.com
استفاده کنید، سپس میتوانید با تنظیمmembership.group_member.name
group_member.name رویgroups/123456789
گروه را به یک فضای نامگذاری شده اضافه یا دعوت کنید. ایمیل گروهی پشتیبانی نمیشود و گروههای Google را فقط میتوان بهعنوان عضو در فضاهای نامگذاریشده اضافه کرد.
درخواست HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
parent | ضروری. نام منبع فضایی که برای آن عضویت ایجاد می شود. قالب: spaces/{space} |
پارامترهای پرس و جو
مولفه های | |
---|---|
useAdminAccess | وقتی کاربر تماس گیرنده باید یک سرپرست Google Workspace با امتیاز مدیریت چت و مکالمات فضاها باشد. به محدوده ایجاد عضویت در برنامه یا ایجاد عضویت برای کاربران خارج از سازمان Google Workspace سرپرست با استفاده از دسترسی سرپرست پشتیبانی نمیشود. |
درخواست بدن
بدنه درخواست شامل نمونه ای از Membership
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Membership
است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chat.admin.memberships
-
https://www.googleapis.com/auth/chat.import
-
https://www.googleapis.com/auth/chat.memberships
-
https://www.googleapis.com/auth/chat.memberships.app
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.