מבנה המניפסט

בדף הזה מתואר המבנה של נתוני ה-JSON ברמה העליונה של קובץ המניפסט של Google Apps Script. המניפסט מגדיר את הפונקציה או המטרה של פרויקט Apps Script.

ייצוג ב-JSON 
{
  "addOns": {
    object (AddOns)
  },
  "chat": {},
  "dependencies": {
    object (Dependencies)
  },
  "exceptionLogging": string,
  "executionApi": {
    object (ExecutionApi)
  },
  "oauthScopes": [
    string
  ],
  "runtimeVersion": string,
  "sheets": {
    object (Sheets)
  },
  "timeZone": string,
  "urlFetchWhitelist": [
    string
  ],
  "webapp": {
    object (Webapp)
  }
}
שדות
addOns

object (AddOns)

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

chat

object

הגדרות הפרויקט אם הפריסה היא של אפליקציית Google Chat.

באפליקציות חדשות ל-Chat, צריך להשתמש בשדה addOns.chat במקום זאת. אם אתם מנהלים אפליקציית Chat קיימת שמשתמשת בשדה chat, הוא צריך להיות אובייקט ריק.

כדי להגדיר את פרטי האפליקציה ל-Chat, צריך להפעיל את Google Chat API. פרטים נוספים זמינים במאמר בנושא הגדרת Google Chat API.

ב-Apps Script, ההרשאה מתבצעת ברמת הסקריפט. אפליקציה ל-Chat שמחייבת הרשאה לא יכולה לבצע פעולות עד שהמשתמש מאשר אותה. כדי לפרסם הודעה לפני אישור ההרשאה, צריך להוסיף אובייקט addToSpaceFallbackMessage למניפסט. אם אפליקציית Chat שלכם דורשת לוגיקה של אתחול, יכול להיות שתצטרכו לשכפל את הלוגיקה הזו בפעולה onMessage.

בדוגמה הבאה מוצגת אפליקציית Chat שמגיבה בהודעת פתיחה שמוגדרת כברירת מחדל כשמשתמש מוסיף אותה למרחב ב-Chat:

        "chat": {
          "addToSpaceFallbackMessage": "Thank you for adding me!"
        }
dependencies

object (Dependencies)

ההגדרה של שירותים מתקדמים ושל ספריות שמופעלים לשימוש בפרויקט הסקריפט.

exceptionLogging

string

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

  • ‫NONE: חריגים לא נרשמים ביומן.
  • STACKDRIVER: חריגות מתועדות ביומנים ב-Stackdriver.
executionApi

object (ExecutionApi)

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

oauthScopes[]

string

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

runtimeVersion

string

גרסת זמן הריצה שבה הסקריפט משתמש. אם לא מציינים את משך הזמן, התסריט משתמש במשך הזמן שמוגדר כברירת מחדל (STABLE). האפשרויות האפשריות הן:

  • ‫STABLE: זמן ריצה שמוגדר כברירת מחדל (כרגע Rhino).
  • ‫V8: סביבת זמן ריצה שמבוססת על V8.
  • ‫DEPRECATED_ES5: סביבת זמן ריצה של Rhino. הערך הזה מונע מעבר אוטומטי ל-V8.
sheets

object (Sheets)

הגדרת המשאב שמגדירה פקודות מאקרו ב-Sheets.

timeZone

string

אזור הזמן של הסקריפט בערך ZoneId כמו America/Denver.
urlFetchWhitelist[]

string

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

webapp

object (Webapp)

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