משאב של המניפסט של 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, הגדרת ברירת המחדל. כתוצאה מכך, אובייקט האירוע שמועבר לפונקציית ההפעלה של ה-compose הוא ברובו ריק.
  • ‫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

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