באמצעות Apps Script API אפשר ליצור ולשנות פרויקטים של Apps Script מהאפליקציה. הדוגמאות בדף הזה ממחישות איך אפשר לבצע פעולות נפוצות לניהול פרויקטים באמצעות ה-API.
הערה: צריך להפעיל את Apps Script API לפני השימוש בו.
בדוגמאות האלה, התו scriptId משמש לציון המיקום שבו צריך לציין את מזהה הפרויקט של הסקריפט. כדי למצוא את מזהה הסקריפט:
- בפרויקט ב-Apps Script, לוחצים על הגדרות הפרויקט בפינה הימנית העליונה.
- לוחצים על העתקה לצד 'מזהה סקריפט'.
יצירת פרויקט חדש ב-Apps Script
הבקשה הבאה מסוג projects.create יוצרת סקריפט עצמאי חדש.
POST https://scriptmanagement.googleapis.com/v1/projects/
{
"title": "My Script"
}אחזור מטא-נתונים של פרויקט
הבקשה הבאה של projects.get מקבלת את המטא-נתונים של הפרויקט של הסקריפט.
GET https://scriptmanagement.googleapis.com/v1/projects/scriptId
התשובה מורכבת מאובייקט, למשל:
{
"scriptId": "scriptId",
"title": "My Title",
"parentId": "parentId",
"createTime": "2017-10-02T15:01:23.045123456Z",
"updateTime": "2017-10-02T15:01:23.045123456Z",
"creator": { "name": "Grant" },
"lastModifyUser": { "name": "Grant" },
}אחזור קבצים של פרויקטים
הבקשה הבאה מסוג projects.getContent מקבלת את התוכן של פרויקט הסקריפט, כולל מקור הקוד והמטא-נתונים של כל קובץ סקריפט.
GET https://scriptmanagement.googleapis.com/v1/projects/scriptId/content
התשובה מורכבת מאובייקט Content, כמו זה:
{ "scriptId": "scriptId", "files": [{ "name": "My Script", "type": "SERVER_JS", "source": "function hello(){\nconsole.log('Hello world');}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z", "functionSet": { "values": [ "name": "helloWorld" ] } }, { "name": "appsscript", "type": "JSON", "source": "{\"timeZone\":\"America/New_York\",\"exceptionLogging\":\"CLOUD\"}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z" }] }
עדכון קובצי הפרויקט
הבקשה הבאה של projects.updateContent מעדכנת את התוכן של פרויקט הסקריפט שצוין. התוכן הזה מאוחסן כגרסת HEAD, והוא משמש כשהסקריפט מופעל כפרויקט הפעלה של API.
PUT https://scriptmanagement.googleapis.com/v1/projects/scriptID/content
{ "files": [{ "name": "index", "type": "HTML", "source": "<html> <header><title>HTML Page</title></header> <body> My HTML </body> </html>" }, { "name": "My Script", "type": "SERVER_JS", "source": "function hello(){\nconsole.log('Hello world');}", }, { "name": "appsscript", "type": "JSON", "source": "{\"timeZone\":\"America/New_York\",\"exceptionLogging\":\"CLOUD\"}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z" }] }
התשובה מורכבת מאובייקט Content, כמו זה:
{ "scriptId": "scriptId", "files": [{ "name": "index", "type": "HTML", "source": "<html> <header><title>HTML Page</title></header> <body> My HTML </body> </html>", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z" }, { "name": "My Script", "type": "SERVER_JS", "source": "function hello(){\nconsole.log('Hello world');}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z", "functionSet": { "values": [ "name": "helloWorld" ] } }, { "name": "appsscript", "type": "JSON", "source": "{\"timeZone\":\"America/New_York\",\"exceptionLogging\":\"CLOUD\"}", "lastModifyUser": { "name": "Grant", "email": "grant@example.com", }, "createTime": "2017-10-02T15:01:23.045123456Z", "updateTime": "2017-10-02T15:01:23.045123456Z" }] }