מבוא

‫Google Apps Script API מאפשר לכם להפוך את היצירה, הניהול וההפעלה של סקריפטים ב-Google Apps Script לאוטומטיים. אתם יכולים ליצור, לשנות ולפרוס פרויקטים של Google Apps Script באופן פרוגרמטי, ולהפעיל פונקציות של Apps Script מרחוק – פעולות שבדרך כלל דורשות שימוש בכלי לעריכת סקריפטים של Apps Script או בממשק המשתמש שלו.

ממשק ה-API הזה משמש לעיתים קרובות כדי:

  • יצירה וניהול של פרויקטים ופריסות של Apps Script.
  • להוסיף או לעדכן פונקציות בפרויקטים של סקריפטים.
  • הפעלת פונקציות של Apps Script מאפליקציות אחרות.
  • מעקב אחרי יומני הביצוע והסטטוסים של הסקריפטים.

בנוסף, Apps Script API מחליף את Apps Script Execution API ומרחיב את הפונקציונליות שלו. אתם יכולים להשתמש ב-Apps Script API כדי להפעיל פונקציות של Apps Script מרחוק, בדיוק כמו שהייתם יכולים לעשות עם Execution API.

כדי להשתמש בממשק ה-API הזה באפליקציות שלכם, אתם צריכים להפעיל אותו.

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

סקירה כללית על API

‫Apps Script API מחולק למספר משאבים, שלכל אחד מהם יש מטרה ספציפית וקבוצה של בקשות שאפשר לשלוח. אלה מקורות המידע:

  • ‫projects – ייצוג של פרויקט סקריפט. ה-API מספק methods ליצירה, לקריאה, למעקב ולשינוי של פרויקטים. אפשר להשתמש במשאב הזה כדי לנהל את קובצי הסקריפט והמטא-נתונים של הפרויקט.
  • ‫projects.deployments — ייצוג של פריסת סקריפט. ה-API מספק שיטות ליצירה, להצגה ברשימה, לעדכון ולמחיקה של פריסות של פרויקטים של סקריפטים. אפשר להשתמש בפריסות כדי להפוך את הסקריפט לזמין כאפליקציית אינטרנט, כתוסף או כקובץ הפעלה.
  • ‫projects.versions — ייצוג של גרסה של פרויקט סקריפט. ה-API מספק שיטות ליצירה ולקריאה של גרסאות פרויקט. אפשר להשתמש בגרסאות כדי לעקוב אחרי איטרציות שונות של פרויקט הסקריפט.
  • ‫processes – ייצוג של ביצוע פונקציית סקריפט. ה-API מספק שיטות לרישום תהליכים קיימים ולאיסוף מידע עליהם, כמו סוג וסטטוס נוכחי. אפשר להשתמש במשאב הזה כדי לעקוב אחרי הרצות של סקריפטים שהופעלו באמצעות השיטה scripts.run.
  • ‫scripts – נקודת הקצה (endpoint) שמספקת שיטות להרצת פונקציות של Apps Script מרחוק. אפשר להשתמש במשאב הזה כדי להפעיל פונקציות בפרויקט הסקריפט מהאפליקציה.