המדריך למתחילים של Google Apps Script

במדריכים למתחילים מוסבר איך מגדירים ומפעילים אפליקציה שמפעילה קריאה ל-Google Workspace API.

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

יוצרים סקריפט של Google Apps ששולח בקשות ל-Google Docs API.

מטרות

  • מגדירים את הסביבה.
  • יוצרים ומגדירים את הסקריפט.
  • מריצים את הסקריפט.

דרישות מוקדמות

  • חשבון Google.
  • גישה ל-Google Drive

יצירת הסקריפט

  1. כדי ליצור סקריפט חדש, עוברים לכתובת script.google.com/create.
  2. מחליפים את התוכן של עורך הסקריפט בקוד הבא:

docs/quickstart/quickstart.gs
/**
 * Prints the title of the sample document:
 * https://docs.google.com/document/d/195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE/edit
 * @see https://developers.google.com/docs/api/reference/rest/v1/documents/get
 */
function printDocTitle() {
  const documentId = '195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE';
  const doc = Docs.Documents.get(documentId, {'includeTabsContent': true});
  console.log(`The title of the doc is: ${doc.title}`);
}

  1. לוחצים על סמל השמירה .
  2. לוחצים על Untitled project, מקלידים Quickstart ולוחצים על Rename.

הגדרת הסקריפט

הפעלת Google Docs API

  1. פותחים את הפרויקט ב-Apps Script.
  1. לוחצים על עריכה .
  2. לצד Services (שירותים), לוחצים על Add a service (הוספת שירות) .
  3. בוחרים את Google Docs API ולוחצים על Add.

הרצת הדוגמה

עורכים את הסקריפט ב-Apps Script ולוחצים על הפעלה.

בפעם הראשונה שתפעילו את הדוגמה, תתבקשו לאשר את הגישה:

  1. לוחצים על בדיקת ההרשאות.
  2. בוחרים חשבון.
  3. לוחצים על אישור.

יומן הביצוע של הסקריפט מופיע בתחתית החלון.

השלבים הבאים