سرویس گفتگوی پیشرفته به شما امکان می دهد از Google Chat API در Apps Script استفاده کنید. این API به اسکریپتها اجازه میدهد فضاهای چت را پیدا، ایجاد و اصلاح کنند، اعضا را به فضاها اضافه یا حذف کنند، و پیامها را با متن، کارت، پیوستها و واکنشها بخوانند یا پست کنند.
پیش نیازها
- یک برنامه Apps Script Google Chat که در صفحه پیکربندی Chat API در کنسول Google Cloud پیکربندی شده است. پروژه Apps Script برنامه باید به جای پروژه پیشفرض که بهطور خودکار برای پروژههای Apps Script ایجاد میشود، از یک پروژه استاندارد Google Cloud استفاده کند. برای ایجاد یک برنامه Google Chat سازگار، به ساخت برنامه Google Chat با برنامههای اسکریپت مراجعه کنید.
- احراز هویت برای برنامه چت پیکربندی شده است. انجام یک عمل از طرف یک کاربر نیاز به احراز هویت کاربر دارد. انجام یک عمل به عنوان برنامه گپ نیاز به احراز هویت برنامه با یک حساب سرویس دارد. برای بررسی اینکه یک روش Chat API از کدام شکل احراز هویت پشتیبانی میکند، به انواع احراز هویت مورد نیاز برای تماسهای Google Chat API مراجعه کنید.
ارجاع
برای اطلاعات بیشتر درباره این سرویس، به مستندات مرجع Chat API مراجعه کنید. مانند همه سرویسهای پیشرفته در Apps Script، سرویس Chat از همان اشیا، روشها و پارامترهای API عمومی استفاده میکند.
کد نمونه
این نمونهها به شما نشان میدهند که چگونه با استفاده از سرویس پیشرفته، اقدامات متداول Google Chat API را انجام دهید.
یک پیام با مشخصات کاربری ارسال کنید
مثال زیر نحوه ارسال پیام به فضای چت از طرف کاربر را نشان می دهد.
دامنه مجوز
chat.messages.create
را به فایلappsscript.json
پروژه Apps Script اضافه کنید:"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.create" ]
تابعی مانند این را به کد پروژه Apps Script اضافه کنید:
پیامی با اعتبار برنامه ارسال کنید
مثال زیر نحوه ارسال پیام به فضای چت از طرف برنامه را نشان می دهد. استفاده از سرویس چت پیشرفته با یک حساب سرویس، نیازی به تعیین محدوده مجوز در appsscript.json
ندارد. برای جزئیات بیشتر درباره احراز هویت با حسابهای سرویس، به تأیید اعتبار بهعنوان برنامه گپ Google مراجعه کنید.
فضا بگیر
مثال زیر نحوه دریافت اطلاعات در مورد فضای چت را نشان می دهد.
دامنه مجوز
chat.spaces.readonly
را به فایلappsscript.json
پروژه Apps Script اضافه کنید:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.readonly" ]
تابعی مانند این را به کد پروژه Apps Script اضافه کنید:
یک فضا ایجاد کنید
مثال زیر نحوه ایجاد فضای چت را نشان می دهد.
محدوده مجوز
chat.spaces.create
را به فایلappsscript.json
پروژه Apps Script اضافه کنید:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.create" ]
تابعی مانند این را به کد پروژه Apps Script اضافه کنید:
لیست عضویت ها
مثال زیر نحوه فهرست کردن همه اعضای یک فضای چت را نشان می دهد.
دامنه مجوز
chat.memberships.readonly
را به فایلappsscript.json
پروژه Apps Script اضافه کنید:"oauthScopes": [ "https://www.googleapis.com/auth/chat.memberships.readonly" ]
تابعی مانند این را به کد پروژه Apps Script اضافه کنید:
عیب یابی
اگر appsscript.json
Error 400: invalid_scope
با پیام خطا مواجه Some requested scopes cannot be shown
. در بیشتر موارد، Apps Script بهطور خودکار تعیین میکند که یک اسکریپت به چه محدودههایی نیاز دارد، اما وقتی از سرویس پیشرفته Chat استفاده میکنید، باید به صورت دستی محدودههای مجوزی را که اسکریپت شما استفاده میکند به فایل مانیفست پروژه Apps Script خود اضافه کنید. به تنظیم دامنه های صریح مراجعه کنید.
برای رفع خطا، محدوده های مجوز مناسب را به فایل appsscript.json
پروژه Apps Script به عنوان بخشی از آرایه oauthScopes
اضافه کنید. به عنوان مثال، برای فراخوانی متد spaces.messages.create
، موارد زیر را اضافه کنید:
"oauthScopes": [
"https://www.googleapis.com/auth/chat.messages.create"
]
محدودیت ها و ملاحظات
سرویس گفتگوی پیشرفته پشتیبانی نمی کند:
- روش Chat API
media.download
. - روشهای Chat API موجود در پیشنمایش برنامهنویس
برای دانلود پیوست پیام یا تماس با روش پیشنمایش برنامهنویس، به جای آن از UrlFetchApp
استفاده کنید.