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

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

AddOns

הרמה העליונה של קובץ המניפסט של תוסף Google Workspace.

ייצוג ב-JSON
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "chat": {
    object (Chat)
  },
  "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.

chat

object ()

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

האובייקט addOns.chat חייב להיות ריק. כדי להגדיר את ההתנהגות והמראה של התוסף ב-Chat, אפשר לעיין במאמר בנושא הגדרת אפליקציית Chat.

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, add-on event objects passed to action callback functions or trigger functions include the locale and timezone information of the user. ברירת המחדל היא false.

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

LayoutProperties

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

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

string

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

string

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

UniversalAction

הגדרה של פעולה אוניברסלית. כשבוחרים פעולה אוניברסלית, היא פותחת את קישור כתובת ה-URL שצוין או מפעילה את פונקציית 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 Script שמופעלת כשהמשתמש בוחר בפעולה הזו.

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