מבנה המניפסט

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

object (Sheets)

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

timeZone

string

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

string

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

webapp

object (Webapp)

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