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