این راهنما نحوه استفاده از متد update() را در منبع Message Google Chat API برای بهروزرسانی پیام نوشتاری یا کارتی در یک فضا توضیح میدهد. برای تغییر ویژگیهای پیام، مانند آنچه میگوید، یا محتوای کارت، یک پیام را بهروزرسانی کنید. همچنین می توانید یک پیام متنی را به پیام کارت اضافه کنید، یا یک کارت را به پیام متنی اضافه کنید.
در Chat API، یک پیام Chat توسط منبع Message نمایش داده می شود. در حالی که کاربران چت فقط میتوانند پیامهایی ارسال کنند که حاوی متن هستند، برنامههای چت میتوانند از بسیاری از ویژگیهای پیامرسانی دیگر، از جمله نمایش رابطهای کاربری استاتیک یا تعاملی، جمعآوری اطلاعات از کاربران، و ارسال پیامها به صورت خصوصی استفاده کنند. برای اطلاعات بیشتر درباره ویژگیهای پیامرسانی موجود برای Chat API، به نمای کلی پیامهای گپ Google مراجعه کنید.
پیش نیازها
Node.js
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- Node.js Cloud Client Library را نصب کنید.
- اعتبارنامه دسترسی را بر اساس نحوه احراز هویت در درخواست Google Chat API خود ایجاد کنید:
- برای احراز هویت به عنوان کاربر چت، اعتبار شناسه مشتری OAuth را ایجاد کنید و اعتبارنامه ها را به عنوان یک فایل JSON با نام
credentials.jsonدر فهرست محلی خود ذخیره کنید. - برای احراز هویت بهعنوان برنامه چت، اعتبار حساب سرویس ایجاد کنید و اعتبارنامهها را بهعنوان فایل JSON با نام
credentials.jsonذخیره کنید.
- برای احراز هویت به عنوان کاربر چت، اعتبار شناسه مشتری OAuth را ایجاد کنید و اعتبارنامه ها را به عنوان یک فایل JSON با نام
- بر اساس اینکه میخواهید بهعنوان کاربر یا برنامه چت احراز هویت کنید ، محدوده مجوز را انتخاب کنید .
پایتون
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- کتابخانه Client Python Cloud را نصب کنید.
- اعتبارنامه دسترسی را بر اساس نحوه احراز هویت در درخواست Google Chat API خود ایجاد کنید:
- برای احراز هویت به عنوان کاربر چت، اعتبار شناسه مشتری OAuth را ایجاد کنید و اعتبارنامه ها را به عنوان یک فایل JSON با نام
credentials.jsonدر فهرست محلی خود ذخیره کنید. - برای احراز هویت بهعنوان برنامه چت، اعتبار حساب سرویس ایجاد کنید و اعتبارنامهها را بهعنوان فایل JSON با نام
credentials.jsonذخیره کنید.
- برای احراز هویت به عنوان کاربر چت، اعتبار شناسه مشتری OAuth را ایجاد کنید و اعتبارنامه ها را به عنوان یک فایل JSON با نام
- بر اساس اینکه میخواهید بهعنوان کاربر یا برنامه چت احراز هویت کنید ، محدوده مجوز را انتخاب کنید .
جاوا
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- کتابخانه Java Cloud Client را نصب کنید.
- اعتبارنامه دسترسی را بر اساس نحوه احراز هویت در درخواست Google Chat API خود ایجاد کنید:
- برای احراز هویت به عنوان کاربر چت، اعتبار شناسه مشتری OAuth را ایجاد کنید و اعتبارنامه ها را به عنوان یک فایل JSON با نام
credentials.jsonدر فهرست محلی خود ذخیره کنید. - برای احراز هویت بهعنوان برنامه چت، اعتبار حساب سرویس ایجاد کنید و اعتبارنامهها را بهعنوان فایل JSON با نام
credentials.jsonذخیره کنید.
- برای احراز هویت به عنوان کاربر چت، اعتبار شناسه مشتری OAuth را ایجاد کنید و اعتبارنامه ها را به عنوان یک فایل JSON با نام
- بر اساس اینکه میخواهید بهعنوان کاربر یا برنامه چت احراز هویت کنید ، محدوده مجوز را انتخاب کنید .
اسکریپت برنامه ها
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
- محیط خود را تنظیم کنید:
- یک پروژه Google Cloud ایجاد کنید .
- صفحه رضایت OAuth را پیکربندی کنید .
- Google Chat API را با نام، نماد و توضیحات برای برنامه Chat خود فعال و پیکربندی کنید .
- یک پروژه Apps Script مستقل ایجاد کنید و سرویس گفتگوی پیشرفته را روشن کنید.
- در این راهنما، باید از احراز هویت کاربر یا برنامه استفاده کنید. برای احراز هویت به عنوان برنامه چت، اعتبارنامه حساب سرویس ایجاد کنید. برای مراحل، به تأیید اعتبار و مجوز به عنوان یک برنامه گپ Google مراجعه کنید.
- بر اساس اینکه میخواهید بهعنوان کاربر یا برنامه چت احراز هویت کنید ، محدوده مجوز را انتخاب کنید .
یک پیام را از طرف یک کاربر به روز کنید
با احراز هویت کاربر ، فقط متن یک پیام را می توان به روز کرد.
برای به روز رسانی یک پیام با احراز هویت کاربر، موارد زیر را در درخواست خود ارسال کنید:
- محدوده مجوز
chat.messagesرا مشخص کنید. - متد
UpdateMessage()را فراخوانی کنید. -
messageبه عنوان نمونه ای ازMessageبا موارد زیر ارسال کنید:- فیلد
nameروی پیام برای بهروزرسانی تنظیم شده است که شامل شناسه فاصله و شناسه پیام است. - فیلد
textبا متن جدید تنظیم شده است.
- فیلد
-
updateMaskباtextمقدار پاس کنید.
اگر پیام بهروزرسانیشده یک پیام کارت باشد، متن به کارتها اضافه میشود (که همچنان نمایش داده میشوند).
در اینجا نحوه به روز رسانی یک پیام، یا اضافه کردن یک پیام متنی به پیام کارت با احراز هویت کاربر آورده شده است:
Node.js
پایتون
جاوا
اسکریپت برنامه ها
برای اجرای این نمونه، موارد زیر را جایگزین کنید:
-
SPACE_NAME: شناسه ازnameفضا. شما می توانید شناسه را با فراخوانی متدListSpaces()یا از URL فضا بدست آورید. -
MESSAGE_NAME: شناسه ازnameپیام. می توانید شناسه را از بدنه پاسخی که پس از ایجاد پیام به طور ناهمزمان با Chat API یا با نام سفارشی اختصاص داده شده به پیام در هنگام ایجاد، بازگردانده شده است، دریافت کنید.
Chat API نمونهای از Message را برمیگرداند که پیامی را که بهروزرسانی میشود، جزئیات میدهد.
یک پیام را به عنوان برنامه چت به روز کنید
با احراز هویت برنامه ، هم متن و هم کارت های یک پیام را می توان به روز کرد.
برای بهروزرسانی پیام با تأیید اعتبار برنامه، موارد زیر را در درخواست خود ارسال کنید:
- محدوده مجوز
chat.botرا مشخص کنید. - متد
UpdateMessage()را فراخوانی کنید. -
messageبه عنوان نمونه ای ازMessageبا موارد زیر ارسال کنید:- فیلد
nameروی پیام برای بهروزرسانی تنظیم شده است که شامل شناسه فاصله و شناسه پیام است. - فیلد
textبا متن جدید در صورت نیاز به بهروزرسانی تنظیم میشود. - فیلد
cardsV2با کارتهای جدید در صورت نیاز به بهروزرسانی تنظیم میشود.
- فیلد
-
updateMaskبا لیست فیلدها به به روز رسانی هایی مانندtextوcardsV2ارسال کنید.
اگر پیام بهروزرسانی شده یک پیام کارت باشد و متن بهروزرسانی شود، متن بهروزرسانی شده به کارتها اضافه میشود (که همچنان نمایش داده میشوند). اگر پیام بهروزرسانی شده یک پیام متنی است و کارتها بهروزرسانی میشوند، کارتهای بهروزرسانی شده به متن اضافه میشوند (که همچنان نمایش داده میشود).
در اینجا نحوه بهروزرسانی متن و کارتهای پیام با تأیید اعتبار برنامه آمده است:
Node.js
پایتون
جاوا
اسکریپت برنامه ها
برای اجرای این نمونه، موارد زیر را جایگزین کنید:
-
SPACE_NAME: شناسه ازnameفضا. شما می توانید شناسه را با فراخوانی متدListSpaces()یا از URL فضا بدست آورید. -
MESSAGE_NAME: شناسه ازnameپیام. می توانید شناسه را از بدنه پاسخی که پس از ایجاد پیام به طور ناهمزمان با Chat API یا با نام سفارشی اختصاص داده شده به پیام در هنگام ایجاد، بازگردانده شده است، دریافت کنید.
Chat API نمونهای از Message را برمیگرداند که پیامی را که بهروزرسانی میشود، جزئیات میدهد.
موضوعات مرتبط
- یک پیام را قالب بندی کنید .
- یک پیام را حذف کنید .
- دریافت جزئیات در مورد یک پیام
- لیست پیام ها در یک فاصله
- پیام بدید .