מבנה המניפסט

בדף הזה מתוארת רמת העליונה של מבנה הנתונים בפורמט JSON בקובץ המניפסט של פרויקט ב-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, צריך להפעיל את Google Chat API. פרטים נוספים זמינים במאמר הגדרת Google Chat API.

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

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