מבנה המניפסט

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

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