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