משאב של המניפסט של Gmail

הגדרת המשאב שמשמשת להגדרת התוכן וההתנהגות של תוסף ל-Google Workspace ב-Gmail. אם התוסף מרחיב את Gmail, כל הרכיבים במניפסט של התוסף ל-Google Workspace צריכים להיות מסומנים כחובה.

Gmail

הגדרת מניפסט של תוסף ל-Google Workspace עבור תוספים ל-Gmail. מידע נוסף זמין במאמר בנושא הרחבת Gmail באמצעות תוספים של Google Workspace.

ייצוג ב-JSON 
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
שדות
authorizationCheckFunction

string

הוצא משימוש. השם של פונקציית Apps Script שמבצעת בדיקות של דרישות הרשאה של צד שלישי. הפונקציה הזו מופעלת לפני כל הפעלה של התוסף של Google Workspace.

הפונקציה הזו הוצאה משימוש כדי למנוע השהיה מיותרת בביצוע. במקום זאת, התוסף צריך להפעיל חריגה מהקריאה הראשית, כמו שמוצג בדוגמה הזו.

composeTrigger

object (ComposeTrigger)

חובה לפעולות של כתיבת הודעה. המדיניות הזו מגדירה את קבוצת ממשקי המשתמש שזמינים למשתמש בזמן כתיבת אימייל.

פרטים נוספים זמינים במאמר בנושא הרחבת ממשק המשתמש של כתיבת הודעות באמצעות פעולות כתיבה.

contextualTriggers[]

object (ContextualTrigger)

חובה. רשימה של טריגרים שמופעלים כשפותחים הודעה ב-Gmail. כשהטריגר מופעל, הוא מריץ פונקציית Apps Script ספציפית, בדרך כלל כדי ליצור כרטיסים חדשים ולעדכן את ממשק המשתמש.
homepageTrigger

object (HomepageTrigger)

המפרט של פונקציית הטריגר ליצירת דף הבית ב-Gmail host. האפשרות הזו מבטלת את addOns.common.homepageTrigger.

ComposeTrigger

ההגדרה של פעולת יצירה. מידע נוסף זמין במאמר בנושא הרחבת ממשק המשתמש של כלי הכתיבה.

ייצוג ב-JSON 
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
שדות
draftAccess

string

הפונקציה הזו מגדירה את רמת הגישה לנתונים שזמינה לפונקציית טריגר של יצירת הודעה. האפשרויות התקינות הן:

  • ‫NONE, הגדרת ברירת המחדל. כתוצאה מכך, אובייקט האירוע שמועבר לפונקציית הטריגר של יצירת ההודעה ריק ברובו.
  • ‫METADATA, שמאכלס את אובייקט האירוע שמועבר לפונקציית הטריגר של הכתיבה ברשימות של הנמענים של ההודעה. כדי שההגדרה הזו תפעל, התוסף צריך לכלול את gmail.addons.current.message.metadata ההיקף.
selectActions[]

object (SelectAction)

רשימה של פעולות כתיבה שיוצרות ממשקי משתמש לכתיבה. עם זאת, הרשימה הזו מוגבלת לפעולה אחת לכל תוסף. לפעולת הכתיבה יש סמל תואם שמוצג בחלון הכתיבה של Gmail. הסמל מוגדר על ידי gmail.logoUrl.

ContextualTrigger

ההגדרה של טריגר שמופעל כשהמשתמש פותח הודעה ב-Gmail, וההודעה עומדת בקריטריונים מסוימים. מידע נוסף זמין במאמר בנושא הרחבת ממשק המשתמש של ההודעות.

ייצוג ב-JSON 
{
  "onTriggerFunction": string,
  "unconditional": {},
}
שדות
onTriggerFunction

string

חובה לכל טריגר הקשרי. השם של פונקציית Apps Script שמופעלת כשהטריגר מופעל.

במאמר פונקציית הפעלה לפי הקשר מוסבר איך מגדירים את הפונקציה הזו.

unconditional

object

חובה לכל טריגר הקשרי. התג הזה משמש כדי לציין שהטריגר ההקשרי מופעל לכל ההודעות ב-Gmail כשהן נפתחות. זו האפשרות היחידה כרגע, ולכן הערך צריך להיות תמיד אובייקט ריק.

SelectAction

ההגדרה של פעולת הכתיבה שמגדירה איזו פונקציה תופעל כשהמשתמש יבחר בפעולת הכתיבה.

ייצוג ב-JSON 
{
  "runFunction": string,
  "text": string
}
שדות
runFunction

string

חובה לפעולות של כתיבת הודעה. השם של פונקציית Apps Script שמופעלת כשבוחרים את פעולת הכתיבה הזו. הפונקציה הזו של הגורם המפעיל ליצירת הודעה בונה את ממשק המשתמש של התוסף ליצירת הודעה.

פרטים נוספים זמינים במאמר בנושא פונקציית טריגר של כתיבת הודעה.

text

string

חובה לפעולות של כתיבת הודעה. תיאור קצר של פעולת ההלחנה הזו.