Action אובייקטים מאפשרים ליצור אובייקטים אינטראקטיביים
ההתנהגות של המשתמשים בתוספים של Google Workspace. הם מגדירים
מה קורה כשמשתמש יוצר אינטראקציה עם ווידג'ט (לדוגמה, לחצן)
בממשק המשתמש של התוסף.
הפעולה מצורפת לווידג'ט נתון באמצעות את פונקציית ה-handler של הווידג'טים, שמגדיר גם את התנאי שמפעיל את הפעולה. כשהיא מופעלת, הפרמטר הפעולה מבצעת פונקציית קריאה חוזרת. פונקציית הקריאה החוזרת מועברת אובייקט אירוע שנושא מידע על האינטראקציות של המשתמש בצד הלקוח. עליך ליישם את פונקציית הקריאה החוזרת כדי להחזיר אובייקט תגובה ספציפי.
לדוגמה, נניח שאתם רוצים לחצן ליצירה ולהצגה של כרטיס חדש
בוצעה לחיצה. לשם כך, צריך ליצור ווידג'ט חדש של לחצנים ולהשתמש בווידג'ט הלחצנים
פונקציית handler
setOnClickAction(action)
כדי להגדיר בניית כרטיסים Action.
Action שמגדירים מציין את Apps Script
פונקציית קריאה חוזרת (callback) שמופעלת כשלוחצים על הלחצן. במקרה הזה,
להטמיע את פונקציית הקריאה החוזרת כדי ליצור את הכרטיס הרצוי ולהחזיר
ActionResponse
לאובייקט. אובייקט התשובה מורה לתוסף להציג את הכרטיס שהקריאה אליו חוזרת
גנרטיבית.
בדף הזה מתוארות פעולות ספציפיות בווידג'ט ל-Gmail שאפשר לכלול
אינטראקציות ב-Gmail
תוספים ל-Google Workspace שמרחיבים את Gmail יכולים לכלול פעולת ווידג'ט נוספת שספציפית ל-Gmail כדי לכתוב טיוטות של הודעות. הזה נדרשת הפעולה המשויכת פונקציית קריאה חוזרת כדי להחזיר אובייקט תגובה מיוחד:
| בוצע ניסיון לפעולה | פונקציית הקריאה החוזרת אמורה לחזור |
|---|---|
| כתיבת טיוטות של הודעות | ComposeActionResponse |
כדי להשתמש בפעולות הווידג'ט ובאובייקטים של התגובות האלה, התוסף צריך
כוללים את
https://www.googleapis.com/auth/gmail.addons.current.action.compose
היקף במניפסט.
כתיבת הודעה
אפשר להשתמש בתוסף של Google Workspace שמרחיב את Gmail
להגדיר ווידג'ט שכשתיצרו איתו אינטראקציה יוצר טיוטות של הודעות ב-Gmail
(הודעות חדשות או תשובות). כדי לעשות את זה, צריך לשייך את
עם פונקציית קריאה חוזרת שמחזירה
ComposeActionResponse
לאובייקט. כשפעולת הקריאה החוזרת תסתיים, Gmail ישתמש בהגדרה הזאת
תשובה כדי לפתוח ולאכלס חלון כתיבה של טיוטה.
פרטים נוספים ודוגמה זמינים במאמר כתיבת טיוטות של הודעות.