MESSAGE با یک منبع Message از Chat API جایگزین کنید. برای کسب اطلاعات بیشتر در مورد نحوه عملکرد اکشنها، به Chat actions مراجعه کنید.
در مثال زیر، یک برنامه چت هر زمان که به یک فاصله اضافه شود، یک پیام متنی ایجاد و ارسال میکند. برای ارسال پیام متنی هنگامی که کاربر برنامه چت شما را به یک فاصله اضافه میکند، برنامه چت شما با بازگرداندن اکشن DataActions به تریگر Added to space پاسخ میدهد:
نود جی اس
/** * Sends an onboarding message when the Chat app is added to a space. * * @param {Object} req The request object from Google Workspace add-on. * @param {Object} res The response object from the Chat app. */exports.cymbalApp=functioncymbalApp(req,res){constchatEvent=req.body.chat;// Send an onboarding message when added to a Chat spaceif(chatEvent.addedToSpacePayload){res.json({hostAppDataAction:{chatDataAction:{createMessageAction:{message:{text:'Hi, Cymbal at your service. I help you manage your calendar'+'from Google Chat. Take a look at your schedule today by typing'+'`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. '+'To learn what else I can do, type `/help`.'}}}}});}};
پایتون
fromflaskimportFlask,request,jsonapp=Flask(__name__)@app.route('/',methods=['POST'])defcymbal_app():"""Sends an onboarding message when the Chat app is added to a space. Returns: Mapping[str, Any]: The response object from the Chat app. """chat_event=request.get_json()["chat"]if"addedToSpacePayload"inchat_event:returnjson.jsonify({"hostAppDataAction":{"chatDataAction":{"createMessageAction":{"message":{"text":'Hi, Cymbal at your service. I help you manage your calendar'+'from Google Chat. Take a look at your schedule today by typing'+'`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. '+'To learn what else I can do, type `/help`.'}}}}})
جاوا
@SpringBootApplication@RestControllerpublicclassApp{publicstaticvoidmain(String[]args){SpringApplication.run(App.class,args);}/* * Sends an onboarding message when the Chat app is added to a space. * * @return The response object from the Chat app. */@PostMapping("/")@ResponseBodypublicGenericJsononEvent(@RequestBodyJsonNodeevent)throwsException{JsonNodechatEvent=event.at("/chat");if(!chatEvent.at("/addedToSpacePayload").isEmpty()){returnnewGenericJson(){{put("hostAppDataAction",newGenericJson(){{put("chatDataAction",newGenericJson(){{put("createMessageAction",newGenericJson(){{put("message",newMessage().setText("Hi, Cymbal at your service. I help you manage your calendar"+"from Google Chat. Take a look at your schedule today by typing"+"`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. "+"To learn what else I can do, type `/help`."));}});}});}});}};}}}
اسکریپت برنامهها
/** * Sends an onboarding message when the Chat app is added to a space. * * @param {Object} event The event object from Chat API. * @return {Object} Response from the Chat app. */functiononAddedToSpace(event){return{hostAppDataAction:{chatDataAction:{createMessageAction:{message:{text:'Hi, Cymbal at your service. I help you manage your calendar'+'from Google Chat. Take a look at your schedule today by typing'+'`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. '+'To learn what else I can do, type `/help`.'}}}}};}
نمونه کد، پیام متنی زیر را برمیگرداند:
برای مثالهای بیشتر در مورد نحوه پاسخ دادن به یک پیام، به راهنماهای زیر مراجعه کنید:
برنامههای چت همچنین میتوانند پیامهایی را که ارسال میکنند بهروزرسانی کنند. برای مثال، برای بهروزرسانی یک پیام پس از اینکه کاربر یک کادر محاورهای ارسال کرده یا روی دکمهای در یک پیام کلیک کرده است.
برای بهروزرسانی پیام یک برنامه چت، اکشن DataActions را به همراه UpdateMessageAction برگردانید، همانطور که در مثال زیر نشان داده شده است:
MESSAGE با یک منبع Message از Chat API جایگزین کنید.
برای کسب اطلاعات بیشتر در مورد نحوه عملکرد اکشنها، به اکشنهای چت مراجعه کنید.
برنامههای چت همچنین میتوانند پیام دریافتی از کاربر را بهروزرسانی کنند تا پیشنمایشی از لینکی که ارسال کرده است را نشان دهند. برای جزئیات بیشتر، به پیشنمایش لینکها در پیامهای چت گوگل مراجعه کنید.
با استفاده از Google Chat API به تعاملات پاسخ دهید یا پیامهای پیشگیرانه ارسال کنید
به جای برگرداندن یک عمل افزونه، برنامههای چت ممکن است نیاز داشته باشند از Google Chat API برای پاسخ به یک تعامل استفاده کنند. برای مثال، برنامههای چت باید Google Chat API را برای انجام هر یک از موارد زیر فراخوانی کنند:
ارسال پیامها طبق برنامه یا در مورد تغییرات در منابع خارجی. به عنوان مثال، اعلانها در مورد یک مسئله یا پرونده جدید.
بیش از ۳۰ ثانیه پس از تعامل پاسخ دهید. به عنوان مثال، برای پاسخ دادن با یک پیام پس از انجام یک کار طولانی مدت.
پیامی را به خارج از فضایی که تعامل در آن رخ داده است، ارسال کنید.
ارسال پیام از طرف یک کاربر چت.
برای ارسال پیام با استفاده از Chat API، باید احراز هویت را تنظیم کرده و متد create() را در منبع Message فراخوانی کنید. برای مراحل، به بخش ارسال پیام با استفاده از Google Chat API مراجعه کنید.
تاریخ آخرین بهروزرسانی 2026-04-01 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-04-01 بهوقت ساعت هماهنگ جهانی."],[],["Google Chat apps can send messages in response to user interactions like message triggers, being added to a space, or button clicks. These messages can include text, cards, or accessory widgets. Apps can use `CreateMessageAction` or `UpdateMessageAction` to reply or update messages. For scheduled messages, or those outside the interaction space, they can call the Google Chat API's `create()` method. Node.js and Apps Script examples are provided to show a text message response to the \"added to space\" trigger.\n"]]