این راهنما نحوه استفاده از متد get() در منبع Membership از API چت گوگل را برای دریافت جزئیات مربوط به عضویت در یک فضا توضیح میدهد.
اگر شما مدیر Google Workspace هستید، میتوانید متد get() را برای بازیابی جزئیات مربوط به هرگونه عضویت در سازمان Google Workspace خود فراخوانی کنید.
منبع Membership نشان میدهد که آیا یک کاربر انسانی یا برنامه Google Chat به یک فضا دعوت شده، بخشی از آن است یا در آن حضور ندارد.
احراز هویت با احراز هویت برنامه به یک برنامه چت اجازه میدهد تا عضویتها را از فضاهایی که در Google Chat به آنها دسترسی دارد (مثلاً فضاهایی که عضو آنهاست) دریافت کند، اما عضویتهای برنامه چت، از جمله عضویتهای خودش را شامل نمیشود. احراز هویت با احراز هویت کاربر ، عضویتها را از فضاهایی که کاربر احراز هویت شده به آنها دسترسی دارد، برمیگرداند.
پیشنیازها
نود جی اس
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- کتابخانه کلاینت ابری Node.js را نصب کنید.
- بر اساس نحوهی احراز هویت در درخواست API چت گوگل خود، اعتبارنامههای دسترسی ایجاد کنید:
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonدر دایرکتوری محلی خود ذخیره کنید. - برای احراز هویت به عنوان برنامه چت، اعتبارنامههای حساب سرویس را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonذخیره کنید.
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
- بر اساس اینکه میخواهید به عنوان کاربر یا برنامه چت احراز هویت کنید ، یک محدوده مجوز انتخاب کنید .
- یک فضای چت گوگل که کاربر احراز هویت شده یا برنامه چت فراخوانی شده عضو آن است. برای احراز هویت به عنوان برنامه چت، برنامه چت را به فضا اضافه کنید .
پایتون
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- کتابخانه کلاینت ابری پایتون را نصب کنید.
- بر اساس نحوهی احراز هویت در درخواست API چت گوگل خود، اعتبارنامههای دسترسی ایجاد کنید:
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonدر دایرکتوری محلی خود ذخیره کنید. - برای احراز هویت به عنوان برنامه چت، اعتبارنامههای حساب سرویس را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonذخیره کنید.
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
- بر اساس اینکه میخواهید به عنوان کاربر یا برنامه چت احراز هویت کنید ، یک محدوده مجوز انتخاب کنید .
- یک فضای چت گوگل که کاربر احراز هویت شده یا برنامه چت فراخوانی شده عضو آن است. برای احراز هویت به عنوان برنامه چت، برنامه چت را به فضا اضافه کنید .
جاوا
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- کتابخانه کلاینت ابری جاوا را نصب کنید.
- بر اساس نحوهی احراز هویت در درخواست API چت گوگل خود، اعتبارنامههای دسترسی ایجاد کنید:
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonدر دایرکتوری محلی خود ذخیره کنید. - برای احراز هویت به عنوان برنامه چت، اعتبارنامههای حساب سرویس را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
credentials.jsonذخیره کنید.
- برای احراز هویت به عنوان کاربر چت، اعتبارنامههای OAuth client ID را ایجاد کنید و اعتبارنامهها را به عنوان یک فایل JSON با نام
- بر اساس اینکه میخواهید به عنوان کاربر یا برنامه چت احراز هویت کنید ، یک محدوده مجوز انتخاب کنید .
- یک فضای چت گوگل که کاربر احراز هویت شده یا برنامه چت فراخوانی شده عضو آن است. برای احراز هویت به عنوان برنامه چت، برنامه چت را به فضا اضافه کنید .
اسکریپت برنامهها
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه گوگل کلود ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- API چت گوگل را با نام، آیکون و توضیحات برای برنامه چت خود فعال و پیکربندی کنید .
- یک پروژه مستقل Apps Script ایجاد کنید و سرویس چت پیشرفته (Advanced Chat Service) را فعال کنید.
- در این راهنما، شما باید از احراز هویت کاربر یا برنامه استفاده کنید. برای احراز هویت به عنوان برنامه چت، اعتبارنامههای حساب سرویس ایجاد کنید. برای مراحل، به «احراز هویت و مجوز به عنوان یک برنامه چت گوگل» مراجعه کنید.
- بر اساس اینکه میخواهید به عنوان کاربر یا برنامه چت احراز هویت کنید ، یک محدوده مجوز انتخاب کنید .
- یک فضای چت گوگل که کاربر احراز هویت شده یا برنامه چت فراخوانی شده عضو آن است. برای احراز هویت به عنوان برنامه چت، برنامه چت را به فضا اضافه کنید .
جزئیات مربوط به عضویت را دریافت کنید
برای دریافت جزئیات مربوط به عضویت در گوگل چت، موارد زیر را در درخواست خود وارد کنید:
- با احراز هویت برنامه ، محدوده مجوز
chat.botرا مشخص کنید. با احراز هویت کاربر ، محدوده مجوزchat.memberships.readonlyیاchat.membershipsرا مشخص کنید. به عنوان یک روش بهتر، محدودترین محدودهای را انتخاب کنید که همچنان به برنامه شما اجازه عملکرد میدهد. - متد
GetMembership()را فراخوانی کنید. - برای دریافت،
nameعضویت را ارسال کنید. نام عضویت را از منبع عضویت گوگل چت دریافت کنید.
با احراز هویت کاربر، عضویت دریافت کنید
در اینجا نحوه دریافت عضویت با احراز هویت کاربر آورده شده است:
نود جی اس
پایتون
جاوا
اسکریپت برنامهها
برای اجرای این نمونه، موارد زیر را جایگزین کنید:
-
SPACE_NAME: شناسهای که ازnameفضا گرفته شده است. میتوانید شناسه را با فراخوانی متدListSpaces()یا از URL فضا به دست آورید. -
MEMBER_NAME: شناسهای که ازnameعضو گرفته شده است. میتوانید شناسه را با فراخوانی متدListMemberships()به دست آورید.
API چت نمونهای از Membership را برمیگرداند که جزئیات عضویت مشخص شده را شرح میدهد.
با احراز هویت برنامه، عضویت دریافت کنید
در اینجا نحوه دریافت عضویت با احراز هویت برنامه آمده است:
نود جی اس
پایتون
جاوا
اسکریپت برنامهها
برای اجرای این نمونه، موارد زیر را جایگزین کنید:
-
SPACE_NAME: شناسهای که ازnameفضا گرفته شده است. میتوانید شناسه را با فراخوانی متدListSpaces()یا از URL فضا به دست آورید. -
MEMBER_NAME: شناسهای که ازnameعضو گرفته شده است. میتوانید شناسه را با فراخوانی متدListMemberships()به دست آورید.
API چت نمونهای از Membership را برمیگرداند که جزئیات عضویت مشخص شده را شرح میدهد.
به عنوان مدیر Google Workspace جزئیات عضویتها را دریافت کنید
اگر شما مدیر Google Workspace هستید، میتوانید متد GetMembership() را برای بازیابی جزئیات عضویت هر کاربر در سازمان Google Workspace خود فراخوانی کنید.
برای فراخوانی این روش به عنوان مدیر Google Workspace، موارد زیر را انجام دهید:
- با استفاده از احراز هویت کاربر، متد را فراخوانی کنید و یک محدوده مجوز مشخص کنید که از فراخوانی متد با استفاده از امتیازات مدیر پشتیبانی کند.
- در درخواست خود، پارامتر query
useAdminAccessرا برابر باtrueقرار دهید.
برای اطلاعات و مثالهای بیشتر، به مدیریت فضاهای چت گوگل به عنوان مدیر فضای کاری گوگل مراجعه کنید.
مباحث مرتبط
- اعضا را در یک فاصله فهرست کنید .
- یک کاربر یا برنامه چت را به یک فضا دعوت یا اضافه کنید .
- عضویت کاربر را در فضای چت گوگل بهروزرسانی کنید .
- حذف یک کاربر یا برنامه چت از یک فضا .