اصالت‌سنجی و صدور مجوز سازوکارهایی هستند که به‌ترتیب برای درستی‌سنجی هویت و دسترسی به منابع استفاده می‌شوند. این سند نحوه عملکرد درستی‌سنجی و مجوز برای برنامه‌های Chat و درخواست‌های Chat API را شرح می‌دهد.
نمای کلی پردازش
نمودار زیر مراحل سطح بالای اصالت‌سنجی و مجوزدهی برای Google Chat را نشان می‌دهد:
پیکربندی پروژه Google Cloud، فعال کردن Chat API، و پیکربندی برنامه Chat: درطول توسعه، پروژه Google Cloud ایجاد می‌کنید. در پروژه Google Cloud، Chat API را فعال می‌کنید، برنامه Chat خود را پیکربندی می‌کنید، و اصالت‌سنجی را راه‌اندازی می‌کنید. برای اطلاعات بیشتر، توسعه در Google Workspace و ساختن برنامه Chat را ببینید.
فراخواندن «میانای برنامه‌سازی کاربردی Chat»: وقتی برنامه شما «میانای برنامه‌سازی کاربردی Chat» را فرا می‌خواند، اطلاعات اعتباری اصالت‌سنجی را به «میانای برنامه‌سازی کاربردی Chat» ارسال می‌کند. اگر برنامه شما با حساب خدماتی اصالت‌سنجی می‌کند، اطلاعات اعتباری به‌عنوان بخشی از کد برنامه شما ارسال می‌شود. اگر برنامه شما نیاز به فراخوانی Chat API بااستفاده از اصالت‌سنجی کاربری دارد که هنوز اعطا نشده است، از کاربر می‌خواهد به سیستم وارد شود.
درخواست منابع: برنامه شما با حوزه‌هایی که هنگام راه‌اندازی اصالت‌سنجی مشخص می‌کنید، درخواست دسترسی می‌کند.
درخواست موافقت: اگر برنامه شما به‌عنوان کاربر اصالت‌سنجی می‌کند، Google صفحه موافقت OAuth را نمایش می‌دهد تا کاربر بتواند تصمیم بگیرد که به برنامه شما اجازه دسترسی به داده‌های درخواستی را بدهد یا نه. اصالت‌سنجی با حساب سرویس به رضایت کاربر نیاز ندارد.
ارسال درخواست تأییدشده برای منابع: اگر کاربر با دامنه‌های مجوز موافقت کند، برنامه شما اطلاعات اعتباری و دامنه‌های تأییدشده کاربر را در درخواستی دسته‌بندی می‌کند. درخواست به سرور مجوز Google ارسال می‌شود تا کد دسترسی دریافت شود.
Google کد دسترسی برمی‌گرداند: کد دسترسی حاوی فهرستی از حوزه‌های اعطاشده است. اگر فهرست برگردانده‌شده محدوده‌های دسترسی محدودتر از محدوده‌های دسترسی درخواست‌شده باشد، برنامه شما هر ویژگی‌ای را که با این کد محدود شده است خاموش می‌کند.
دسترسی به منابع درخواستی: برنامه شما از کد دسترسی Google برای فراخوانی Chat API و دسترسی به منابع Chat API استفاده می‌کند.
دریافت کد بازآوری (اختیاری): اگر برنامه شما باید فراتر از طول عمر یک کد دسترسی واحد به Google Chat API دسترسی داشته باشد، می‌تواند کد بازآوری دریافت کند. برای اطلاعات بیشتر، به استفاده از OAuth 2.0 برای دسترسی به Google APIs مراجعه کنید.
درخواست منابع بیشتر: اگر برنامه شما به دسترسی بیشتری نیاز داشته باشد، از کاربر می‌خواهد تا دامنه‌های جدیدی را اعطا کند که منجر به درخواست جدیدی برای دریافت کد دسترسی می‌شود (مراحل ۳ تا ۶).
وقتی برنامه‌های Chat به اصالت‌سنجی نیاز دارند
برنامه‌های Chat می‌توانند در پاسخ به تعامل کاربر یا به‌صورت ناهمزمان پیام ارسال کنند. همچنین می‌تواند تکالیف را ازطرف کاربر انجام دهد، مثلاً فضای Chat ایجاد کند یا فهرست افراد در فضای Chat را دریافت کند.
برنامه‌های Chat برای پاسخ دادن به تعامل کاربر به اصالت‌سنجی نیاز ندارند، مگر اینکه برنامه Chat درحین پردازش پاسخ، Chat API یا Google API دیگری را فراخوانی کند.
برای ارسال پیام‌های ناهمگام یا انجام تکالیف ازطرف کاربر، برنامه‌های Chat درخواست‌های RESTful به Chat API ارسال می‌کنند که به اصالت‌سنجی و صدور مجوز نیاز دارد.
پاسخ به تعاملات کاربر نیازی به اصالت‌سنجی ندارد
برنامه‌های Google Chat برای دریافت و پاسخ همزمان به رویدادهای تعامل نیازی به اصالت‌سنجی به‌عنوان کاربر یا برنامه Chat ندارند.
برنامه‌های Google Chat هرگاه کاربری با برنامه Chat تعامل برقرار کند یا آن را فراخوانی کند، رویدادهای تعامل دریافت می‌کنند، ازجمله:
- کاربری پیامی را به برنامه Chat ارسال می‌کند.
- کاربری از برنامه Chat @نام می‌برد.
- کاربری یکی از فرمان‌های برنامه Chat را فرا می‌خواند.
نمودار زیر توالی درخواست-پاسخ بین کاربر Chat و برنامه Chat را نشان می‌دهد:
- کاربر پیامی را به برنامه Chat در Google Chat ارسال می‌کند.
- Google Chat پیام را به برنامه بازارسال می‌کند.
- برنامه پیام را دریافت می‌کند، آن را پردازش می‌کند، و پاسخی به Google Chat برمی‌گرداند.
- Google Chat پاسخ را برای کاربر یا در فضا ارائه می‌کند.
این توالی برای هر رویداد تعامل برنامه Chat تکرار می‌شود.
پیام‌های ناهمزمان به اصالت‌سنجی نیاز دارند
پیام‌های ناهمگام زمانی رخ می‌دهد که برنامه Chat درخواستی به Chat API ارسال می‌کند که به اصالت‌سنجی و صدور مجوز نیاز دارد.
برنامه‌های Chat با فراخوانی Chat API می‌توانند پیام‌هایی در Google Chat پست کنند یا تکالیف را تکمیل کنند و ازطرف کاربر به داده‌ها دسترسی پیدا کنند. برای مثال، پس‌از شناسایی قطعی سرور، برنامه Chat می‌تواند «میانای برنامه‌سازی کاربردی Chat» را برای انجام این کارها فرابخواند:
- فضای Chat اختصاصی برای بررسی و رفع قطعی ایجاد کنید.
- افراد را به فضای Chat اضافه کنید.
- برای ارائه جزئیات درباره قطعی، پیامی در فضای Chat پست کنید.
نمودار زیر توالی پیام ناهمگام بین برنامه Chat و فضای Chat را نشان می‌دهد:
- برنامه Chat با فراخوانی
Chat API بااستفاده از
spaces.messages.createروش، پیامی ایجاد می‌کند و اطلاعات اعتباری کاربر را در درخواست HTTP قرار می‌دهد. - Google Chat برنامه Chat را با حساب سرویس یا اعتبارنامه‌های کاربر اصالت‌سنجی می‌کند.
- Google Chat پیام برنامه را در فضای Chat مشخص‌شده‌ای پردازش می‌کند.
قلمروهای Chat API
صفحه موافقت OAuth را پیکربندی کنید و محدوده‌ها را انتخاب کنید تا مشخص کنید چه اطلاعاتی به کاربران و مرورکنندگان برنامه نمایش داده شود، و برنامه خود را ثبت کنید تا بتوانید آن را بعداً منتشر کنید.
برای تعریف سطح دسترسی اعطاشده به برنامه‌تان، باید حوزه‌های مجوز را شناسایی و اعلام کنید. محدوده مجوز یک رشته نشانی وب OAuth 2.0 است که حاوی نام برنامه Google Workspace، نوع داده‌هایی که به آن‌ها دسترسی دارد، و سطح دسترسی است.
حوزه‌های غیرحساس
| کد حوزه | شرح |
|---|---|
https://www.googleapis.com/auth/chat.bot
|
به برنامه‌های Chat اجازه می‌دهد گپ‌ها را مشاهده کنند و پیام ارسال کنند. این محدوده فقط از اصالت‌سنجی برنامه با حساب‌های سرویس پشتیبانی می‌کند. نمی‌توانید با اعتبارنامه‌های کاربر یا با واگذاری اختیارات در سطح دامنه بااستفاده از این محدوده اصالت‌سنجی کنید. |
محدوده‌های حساس
| کد حوزه | شرح |
|---|---|
https://www.googleapis.com/auth/chat.spaces
|
ایجاد مکالمه و فضا و دیدن یا ویرایش فراداده‌ها (ازجمله تنظیمات سابقه و تنظیمات دسترسی) در Chat. |
https://www.googleapis.com/auth/chat.spaces.create
|
ایجاد مکالمه‌های جدید در Chat. |
https://www.googleapis.com/auth/chat.spaces.readonly
|
گپ و فضاها را در Chat مشاهده کنید. |
https://www.googleapis.com/auth/chat.memberships
|
مشاهده، افزودن، به‌روزرسانی، و برداشتن اعضا از مکالمه‌ها در Chat. |
https://www.googleapis.com/auth/chat.memberships.app
|
افزودن و برداشتن خودش از مکالمه‌های Google Chat. |
https://www.googleapis.com/auth/chat.memberships.readonly
|
مشاهده اعضا در مکالمه‌های Chat. |
https://www.googleapis.com/auth/chat.messages.create
|
نوشتن و ارسال پیام در Chat. |
https://www.googleapis.com/auth/chat.messages.reactions
|
مشاهده، افزودن، و حذف واکنش به پیام‌ها در Chat. |
https://www.googleapis.com/auth/chat.messages.reactions.create
|
به پیامی در Chat واکنش نشان دهید. |
https://www.googleapis.com/auth/chat.messages.reactions.readonly
|
واکنش‌ها به پیام در Chat را مشاهده کنید. |
https://www.googleapis.com/auth/chat.users.readstate
|
مشاهده و تغییر آخرین زمان خواندن مکالمه‌های Chat. |
https://www.googleapis.com/auth/chat.users.readstate.readonly
|
مشاهده آخرین زمان خواندن مکالمه‌های Chat. |
https://www.googleapis.com/auth/chat.admin.spaces.readonly
|
مشاهده گپ و فضاهای متعلق به دامنه سرپرست در Chat. |
https://www.googleapis.com/auth/chat.admin.spaces
|
مشاهده یا ویرایش گپ و فضاهای متعلق به دامنه سرپرست در Chat. |
https://www.googleapis.com/auth/chat.admin.memberships.readonly
|
مشاهده اعضا و مدیران در مکالمه‌های متعلق به دامنه سرپرست در Chat. |
https://www.googleapis.com/auth/chat.admin.memberships
|
مشاهده، افزودن، به‌روزرسانی، و برداشتن اعضا و مدیران در مکالمه‌های متعلق به دامنه سرپرست در Chat. |
https://www.googleapis.com/auth/chat.app.spaces
|
ایجاد مکالمه و فضا و مشاهده یا به‌روزرسانی فراداده‌ها (ازجمله تنظیمات سابقه و تنظیمات دسترسی) در Chat به‌عنوان برنامه Chat. به تأیید سرپرست نیاز دارد. این محدوده فقط از اصالت‌سنجی برنامه با حساب‌های سرویس پشتیبانی می‌کند. نمی‌توانید با اعتبارنامه‌های کاربر یا با واگذاری اختیارات در سطح دامنه بااستفاده از این محدوده اصالت‌سنجی کنید. |
https://www.googleapis.com/auth/chat.app.spaces.readonly
|
فراداده‌ها (ازجمله تنظیمات سابقه) را در Chat به‌عنوان برنامه Chat مشاهده کنید. به تأیید سرپرست نیاز دارد. این محدوده فقط از اصالت‌سنجی برنامه با حساب‌های سرویس پشتیبانی می‌کند. نمی‌توانید با اعتبارنامه‌های کاربر یا با واگذاری اختیارات در سطح دامنه بااستفاده از این محدوده اصالت‌سنجی کنید. |
https://www.googleapis.com/auth/chat.app.spaces.create
|
ایجاد مکالمه‌ها و فضاهای جدید در Chat به‌عنوان برنامه Chat. به تأیید سرپرست نیاز دارد. این محدوده فقط از اصالت‌سنجی برنامه با حساب‌های سرویس پشتیبانی می‌کند. نمی‌توانید با اعتبارنامه‌های کاربر یا با واگذاری اختیارات در سطح دامنه بااستفاده از این محدوده اصالت‌سنجی کنید. |
https://www.googleapis.com/auth/chat.app.memberships
|
مشاهده، افزودن، به‌روزرسانی، و برداشتن اعضا از مکالمه‌ها و فضاها در Chat به‌عنوان برنامه Chat. به تأیید سرپرست نیاز دارد. این محدوده فقط از اصالت‌سنجی برنامه با حساب‌های سرویس پشتیبانی می‌کند. نمی‌توانید با اعتبارنامه‌های کاربر یا با واگذاری اختیارات در سطح دامنه بااستفاده از این محدوده اصالت‌سنجی کنید. |
https://www.googleapis.com/auth/chat.app.memberships.readonly
|
دیدن اعضای مکالمه‌ها و فضاها در Chat به‌عنوان برنامه Chat. به تأیید سرپرست نیاز دارد. این محدوده فقط از اصالت‌سنجی برنامه با حساب‌های سرویس پشتیبانی می‌کند. نمی‌توانید با اعتبارنامه‌های کاربر یا با واگذاری اختیارات در سطح دامنه بااستفاده از این محدوده اصالت‌سنجی کنید. |
https://www.googleapis.com/auth/chat.customemojis
|
مشاهده، ایجاد، و حذف اموجی سفارشی در Chat. |
https://www.googleapis.com/auth/chat.customemojis.readonly
|
مشاهده اموجی سفارشی در Chat. |
https://www.googleapis.com/auth/chat.users.spacesettings
|
مشاهده و به‌روزرسانی تنظیمات فضای کاربر Chat. |
https://www.googleapis.com/auth/chat.users.sections
|
مشاهده کردن، ایجاد کردن، به‌روز کردن، و حذف کردن بخش‌های شما در Chat؛ انتقال دادن و فهرست کردن موارد بخش شما در Chat. |
https://www.googleapis.com/auth/chat.users.sections.readonly
|
بخش‌هایتان و موارد بخش آن‌ها را در Chat مشاهده کنید. |
محدوده‌های محدودشده
| کد حوزه | شرح |
|---|---|
https://www.googleapis.com/auth/chat.delete
|
حذف مکالمه‌ها و فضاها و برداشتن دسترسی به فایل‌های منسوب در Chat. |
https://www.googleapis.com/auth/chat.import
|
وارد کردن فضاها، پیام‌ها، و اعضا در Chat. برای اطلاعات بیشتر، مجوز دادن به برنامه‌های Chat برای وارد کردن داده‌ها را ببینید |
https://www.googleapis.com/auth/chat.messages
|
مشاهده، نوشتن، ارسال، به‌روزرسانی، و حذف پیام‌ها و افزودن، مشاهده، و حذف واکنش به پیام‌ها. |
https://www.googleapis.com/auth/chat.messages.readonly
|
مشاهده پیام‌ها و واکنش‌ها در Chat. |
https://www.googleapis.com/auth/chat.app.messages.readonly
|
مشاهده پیام‌ها و واکنش‌ها در Chat به‌عنوان برنامه Chat. به تأیید سرپرست نیاز دارد. این محدوده فقط از اصالت‌سنجی برنامه با حساب‌های سرویس پشتیبانی می‌کند. نمی‌توانید با اعتبارنامه‌های کاربر یا با واگذاری اختیارات در سطح دامنه بااستفاده از این محدوده اصالت‌سنجی کنید. |
https://www.googleapis.com/auth/chat.admin.delete
|
حذف مکالمه‌ها و فضاهای متعلق به دامنه سرپرست، و برداشتن دسترسی به فایل‌های مرتبط در Chat. |
https://www.googleapis.com/auth/chat.app.delete
|
حذف مکالمه‌ها و فضاها و برداشتن دسترسی به فایل‌های مرتبط در Chat به‌عنوان برنامه Chat. به تأیید سرپرست نیاز دارد. این محدوده فقط از اصالت‌سنجی برنامه با حساب‌های سرویس پشتیبانی می‌کند. نمی‌توانید با اعتبارنامه‌های کاربر یا با واگذاری اختیارات در سطح دامنه بااستفاده از این محدوده اصالت‌سنجی کنید. |
حوزه‌های موجود در جدول‌های قبلی براساس تعاریف زیر نشان‌دهنده حساسیت آن‌ها است:
غیرحساس—این محدوده‌ها کوچک‌ترین حوزه دسترسی مجوز را ارائه می‌دهند و فقط به درستی‌سنجی اولیه برنامه نیاز دارند. برای اطلاعات درباره این الزام، مراحل آماده شدن برای درستی‌سنجی را ببینید.
حساس—این محدوده‌ها پس‌از دریافت مجوز از کاربر، به برنامه شما امکان دسترسی به داده‌های Google کاربر خاصی را می‌دهند. این کار مستلزم این است که درستی‌سنجی برنامه اضافی را انجام دهید. برای کسب اطلاعات درباره این الزام، مراحل برنامه‌هایی که دامنه‌های حساس درخواست می‌کنند را ببینید.
محدود—این حوزه‌ها دسترسی گسترده‌ای به داده‌های کاربر Google ارائه می‌دهند و لازم است که فرایند درستی‌سنجی حوزه محدود را طی کنید. برای اطلاعات بیشتر درباره این الزام، خدمات Google API: خط‌مشی داده‌های کاربر و الزامات اضافی برای محدوده‌های API خاص را ببینید. همچنین مراحل برنامه‌هایی که دامنه‌های محدودشده را درخواست می‌کنند را ببینید.
اگر برنامه شما به هر API دیگری از Google نیاز دارد، می‌توانید آن محدوده‌ها را نیز اضافه کنید. برای اطلاعات بیشتر درباره محدوده‌های Google API، به استفاده از OAuth 2.0 برای دسترسی به Google APIs مراجعه کنید.
برای کسب اطلاعات بیشتر درباره محدوده‌های «میاناهای برنامه‌سازی کاربردی Google Workspace»، به پیکربندی صفحه موافقت OAuth و انتخاب محدوده‌ها مراجعه کنید.
انواع اصالت‌سنجی موردنیاز
برنامه‌های Chat به دو روش می‌توانند با «میانای برنامه‌سازی کاربردی Chat» اصالت‌سنجی و صدور مجوز کنند:
- اصالت‌سنجی کاربر
- اصالت‌سنجی کاربر به برنامه Chat اجازه می‌دهد به داده‌های کاربر دسترسی داشته باشد و کنش‌ها را ازطرف کاربر انجام دهد. محدوده‌های OAuth داده‌ها و کنش‌های مجاز را مشخص می‌کنند. مگر اینکه برنامه Chat توسط سرپرست نصب شده باشد یا واگذاری در سطح دامنه به آن داده شده باشد، اولین‌باری که برنامه Chat کنشی را ازطرف کاربر انجام می‌دهد، کاربر باید برنامه Chat را بااستفاده از صفحه موافقت OAuth مجاز کند.
- اصالت‌سنجی برنامه
اصالت‌سنجی برنامه به برنامه Chat اجازه می‌دهد از اطلاعات اعتباری حساب سرویس استفاده کند و به داده‌ها دسترسی داشته باشد و کنش‌ها را به‌عنوان خودش تکمیل کند. چون برنامه Chat از اطلاعات اعتباری خودش برای دسترسی به منابع و کار با آن‌ها استفاده می‌کند، کاربران نهایی نیازی به تأیید فراخوانی‌های API برنامه Chat ندارند، و نمی‌توانید دامنه‌های مجوز OAuth را که از مجوز برنامه پشتیبانی می‌کنند به صفحه موافقت OAuth اضافه کنید.
دو نوع محدوده مجوز OAuth از اصالت‌سنجی برنامه پشتیبانی می‌کنند:
https://www.googleapis.com/auth/chat.bot: برنامه Chat شما می‌تواند روش‌های Google Chat API را که از این محدوده مجوز پشتیبانی می‌کنند فراخوانی کند تا منابعی را که به آن‌ها دسترسی دارد (مثل پیام‌های موجود در فضاهایی که کاربران نهایی برنامه Chat شما را به آن‌ها اضافه می‌کنند) ایجاد، به‌روزرسانی، دریافت، فهرست، یا حذف کند. برنامه Chat شما می‌تواند این حوزه مجوز را به خود اعطا کند، نیازی به مجوز سرپرست یا کاربر نهایی نیست.https://www.googleapis.com/auth/chat.app.*: استفاده از این محدوده‌ها نیاز به تأیید یک‌باره سرپرست دارد. برای دریافت تأیید سرپرست، حساب سرویس برنامه Chat را برای دریافت تأیید سرپرست آماده می‌کنید با ایجاد یک کارخواه OAuth سازگار با Google Workspace Marketplace و پیکربندی برنامه در Google Workspace Marketplace SDK. این محدوده‌ها به برنامه Chat شما اجازه می‌دهند روش‌های خاصی از Google Chat API را فراخوانی کند. برای مثال،chat.app.spaces.createبه برنامه‌ها اجازه می‌دهد فضاهای Chat ایجاد کنند.
اگر روشی از اصالت‌سنجی کاربر یا برنامه پشتیبانی کند، «میانای برنامه‌سازی کاربردی Chat» براساس نوع اصالت‌سنجی که استفاده می‌کنید نتایج متفاوتی برمی‌گرداند:
- با اصالت‌سنجی برنامه، روش‌ها فقط منابعی را برمی‌گردانند که برنامه Chat می‌تواند به آن‌ها دسترسی داشته باشد.
- با اصالت‌سنجی کاربر، روش‌ها فقط منابعی را برمی‌گردانند که کاربر می‌تواند به آن‌ها دسترسی داشته باشد.
برای مثال، فراخوانی روش spaces.list() با مجوز برنامه فهرست فضاهایی را که برنامه Chat عضو آن‌ها است برمی‌گرداند.
فراخوانی spaces.list() با
مجوز کاربر فهرست فضاهایی را که کاربر عضو آن‌ها است برمی‌گرداند. در عمل، ممکن است بسته به طراحی و ویژگی‌های برنامه Chat خود، هنگام فراخوانی Chat API از هر دو نوع اصالت‌سنجی استفاده کنید.
برای تماس‌های غیرهم‌زمان Chat API
جدول زیر روش‌های Chat API و دامنه‌های مجوز پشتیبانی‌شده آن‌ها را فهرست می‌کند:
| روش | اصالت‌سنجی کاربر پشتیبانی می‌شود | اصالت‌سنجی برنامه پشتیبانی می‌شود | حوزه‌های مجوز پشتیبانی‌شده | |
|---|---|---|---|---|
| فضاها | ||||
| ایجاد فضا |
با اصالت‌سنجی کاربر:
|
|||
| راه‌اندازی فضا | — |
با اصالت‌سنجی کاربر:
|
||
| دریافت فضا |
با اصالت‌سنجی کاربر:
|
|||
| فهرست کردن فضاها |
با اصالت‌سنجی کاربر:
|
|||
| جستجوی فضاها | — |
با اصالت‌سنجی کاربر بااستفاده از امتیازهای سرپرست:
|
||
| به‌روزرسانی فضا |
با اصالت‌سنجی کاربر:
|
|||
| حذف فضا |
با اصالت‌سنجی کاربر:
|
|||
| تکمیل کردن فرایند وارد کردن برای فضا | — |
با اصالت‌سنجی کاربر:
|
||
| پیدا کردن پیام مستقیم |
با اصالت‌سنجی کاربر:
|
|||
| اعضا | ||||
| ایجاد عضو |
با اصالت‌سنجی کاربر:
|
|||
| دریافت عضو |
با اصالت‌سنجی کاربر:
|
|||
| فهرست اعضا |
با اصالت‌سنجی کاربر:
|
|||
| حذف عضو |
با اصالت‌سنجی کاربر:
|
|||
| به‌روزرسانی عضو |
با اصالت‌سنجی کاربر:
|
|||
| پیام‌ها | ||||
| ایجاد پیام |
با اصالت‌سنجی کاربر:
|
|||
| دریافت پیام |
با اصالت‌سنجی کاربر:
|
|||
| فهرست کردن پیام‌ها |
با اصالت‌سنجی کاربر:
|
|||
| جستجوی پیام‌ها | — |
با اصالت‌سنجی کاربر:
|
||
| به‌روزرسانی پیام |
با اصالت‌سنجی کاربر:
|
|||
| حذف پیام |
با اصالت‌سنجی کاربر:
|
|||
| سنجاق کردن پیام | — |
با اصالت‌سنجی کاربر:
|
||
| برداشتن سنجاق پیام | — |
با اصالت‌سنجی کاربر:
|
||
| فهرست کردن پیام‌های سنجاق‌شده | — |
با اصالت‌سنجی کاربر:
|
||
| به‌روزرسانی کارت‌ها در پیام | — |
با اصالت‌سنجی برنامه:
|
||
| واکنش‌ها | ||||
| ایجاد واکنش | — |
با اصالت‌سنجی کاربر:
|
||
| فهرست کردن واکنش‌ها | — |
با اصالت‌سنجی کاربر:
|
||
| حذف واکنش | — |
با اصالت‌سنجی کاربر:
|
||
| اموجی سفارشی | ||||
| ایجاد اموجی سفارشی | — |
با اصالت‌سنجی کاربر:
|
||
| حذف اموجی سفارشی | — |
با اصالت‌سنجی کاربر:
|
||
| دریافت اموجی سفارشی | — |
با اصالت‌سنجی کاربر:
|
||
| فهرست کردن اموجی سفارشی | — |
با اصالت‌سنجی کاربر:
|
||
| رسانه و پیوست‌ها | ||||
| بارگذاری رسانه به‌عنوان پیوست فایل | — |
با اصالت‌سنجی کاربر:
|
||
| بارگیری رسانه |
با اصالت‌سنجی کاربر:
|
|||
| دریافت پیوست پیام | — |
با اصالت‌سنجی برنامه:
|
||
| وضعیت‌های خواندن کاربر | ||||
| دریافت وضعیت خوانده شدن فضای کاربر | — |
با اصالت‌سنجی کاربر:
|
||
| به‌روزرسانی وضعیت خوانده شدن فضای کاربر | — |
با اصالت‌سنجی کاربر:
|
||
| دریافت وضعیت خوانده شدن رشته کاربر | — |
با اصالت‌سنجی کاربر:
|
||
| تنظیمات فضای کاربر | ||||
| دریافت تنظیم اعلان فضای کاربر | — |
با اصالت‌سنجی کاربر:
|
||
| به‌روزرسانی تنظیم اعلان فضای کاربر | — |
با اصالت‌سنجی کاربر:
|
||
| رویدادهای فضا | ||||
| دریافت رویدادهای فضا | — |
با اصالت‌سنجی کاربر،
باید از دامنه‌ای براساس
نوع رویداد استفاده کنید:
|
||
| فهرست کردن رویدادهای فضا | — |
با اصالت‌سنجی کاربر،
باید برای هر
نوع رویداد که در درخواست گنجانده شده است از حوزه استفاده کنید:
|
||
| بخش‌ها | ||||
| ایجاد بخش | — |
با اصالت‌سنجی کاربر:
|
||
| حذف بخش | — |
با اصالت‌سنجی کاربر:
|
||
| فهرست کردن بخش‌ها | — |
با اصالت‌سنجی کاربر:
|
||
| به‌روزرسانی بخش | — |
با اصالت‌سنجی کاربر:
|
||
| موقعیت‌دهی بخش | — |
با اصالت‌سنجی کاربر:
|
||
| موارد بخش | ||||
| انتقال مورد بخش | — |
با اصالت‌سنجی کاربر:
|
||
| فهرست کردن موارد بخش | — |
با اصالت‌سنجی کاربر:
|
||
برای رویدادهای تعامل برنامه Chat
جدول زیر روش‌های رایجی را که کاربران با برنامه‌های Chat تعامل می‌کنند فهرست می‌کند و نشان می‌دهد که آیا اصالت‌سنجی لازم است یا پشتیبانی می‌شود:
| سناریو | اصالت‌سنجی لازم نیست | اصالت‌سنجی کاربر پشتیبانی می‌شود | اصالت‌سنجی برنامه پشتیبانی می‌شود | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| دریافت پیام از: |
|
|||||||||||||||
| پاسخ دادن به پیام‌ها: |
|
|||||||||||||||
| ارسال پیام‌های جدید: |
|
|||||||||||||||
موضوعات مرتبط
- برای نمای کلی اصالت‌سنجی و صدور مجوز در Google Workspace، به آشنایی با اصالت‌سنجی و صدور مجوز مراجعه کنید.
- برای نمای کلی اصالت‌سنجی و صدور مجوز در Google Cloud، به نمای کلی اصالت‌سنجی مراجعه کنید.
- برای کسب اطلاعات بیشتر درباره حساب‌های سرویس، به حساب‌های سرویس مراجعه کنید.
- برای کسب اطلاعات بیشتر درباره نحوه استفاده Google APIs از OAuth 2.0، به استفاده از OAuth 2.0 برای دسترسی به Google APIs مراجعه کنید.
- اصالت‌سنجی و مجوز را با اطلاعات اعتباری کاربر یا حساب خدمات راه‌اندازی کنید.
- برای مدیریت اجازه‌های جزئی OAuth، به مدیریت اجازه‌های جزئی OAuth برای برنامه‌های Google Chat مراجعه کنید.