משאב מניפסט של AddOns

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

AddOns

הרמה העליונה של הגדרת המניפסט של תוסף Google Workspace.

ייצוג JSON
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
שדות
common

object (Common)

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

calendar

object (Calendar)

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

drive

object (Drive)

חובה אם התוסף של Google Workspace מרחיב את Google Drive. הגדרות המראה וההתנהגות של התוספים ל-Google Workspace באפליקציה המארחת ב-Google Drive. אם לא תציינו את השדה הזה, התוסף יושבת ב-Google Drive.

gmail

object (Gmail)

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

docs

object (Docs)

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

sheets

object (Sheets)

חובה אם התוסף של Google Workspace מרחיב את Sheets. הגדרות למראה ולהתנהגות של התוסף ל-Google Workspace באפליקציית האירוח של Sheets. אם לא תציינו את השדה הזה, התוסף יושבת ב-Sheets.

slides

object (Slides)

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

נפוצות

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

ייצוג JSON
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
שדות
homepageTrigger

object (HomepageTrigger)

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

object (LayoutProperties)

תצורה לצבעים שנעשה בהם שימוש בסרגל הכלים של התוסף ובלחצנים.
logoUrl

string

חובה. כתובת ה-URL של התמונה המוצגת בסרגל הכלים. כתובת ה-URL חייבת להיות ציבורית.

name

string

חובה. שם התוסף שמופיע בסרגל הכלים.

openLinkUrlPrefixes[]

string

חובה אם התוסף מציג קישורים שמפנים אל מחוץ לאתר, בין אם בתוך ווידג'טים באמצעות OpenLink או בווידג'ט של טקסט שמשתמש בתגי עוגן של HTML. רשימת הקידומות של כתובות URL מסוג HTTPS. כדי להגן על נתוני המשתמשים, כל קישור שהתוסף מעבד חייב להתאים לאחת מהקידומות שברשימה.

פרטים נוספים זמינים במאמר כתובות URL של רשימות היתרים.

universalActions[]

object (UniversalAction)

רשימה של פעולות אוניברסליות שתמיד זמינות בממשק המשתמש של התוסף.
useLocaleFromApp

boolean

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

לפרטים נוספים, אפשר לקרוא את המאמר גישה לאזורי זמן וללוקאל של משתמשים.

LayoutProperties

הגדרה אישית שקובעת את הצבעים והמראה של Google Workspace סרגל הכלים ואת המראה של לחצנים.

ייצוג JSON
{
  "primaryColor": string,
  "secondaryColor": string
}
שדות
primaryColor

string

צבע סרגל הכלים. ברירת המחדל היא אפור (#424242).
secondaryColor

string

צבע ברירת המחדל של הלחצנים. ברירת המחדל היא הצבע הראשי (אם הוגדר ). אחרת, ברירת המחדל היא כחול (#2196F3).

UniversalAction

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

ייצוג JSON
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
שדות
label

string

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

string

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

לפרטים נוספים, אפשר לעיין במדריך פעולות אוניברסליות.