מבנה המניפסט

בדף הזה מתואר המבנה של נתוני ה-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, השדה הזה צריך להיות אובייקט ריק.

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

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

בדוגמה הבאה מוצגת אפליקציית צ'אט שמגיבה בהודעת פתיחה שמוגדרת כברירת מחדל כשמשתמש מוסיף אותה למרחב ב-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)

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