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

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

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

לכתוב Google Apps Script שמבצע בקשות ל-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';
  try {
    // Get the document using document id
    const doc = Docs.Documents.get({'includeTabsContent': true}, documentId);
    // Log the title  of document.
    console.log('The title of the doc is: %s', doc.title);
  } catch (err) {
    // TODO (developer) - Handle exception from Docs API
    console.log('Failed to found document with an error %s', err.message);
  }
}

  1. לוחצים על 'שמירה' .
  2. לוחצים על פרויקט ללא שם, מקלידים מדריך למתחילים, ולוחצים על שינוי שם.

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

הפעלת Google Docs API

  1. פותחים את פרויקט Apps Script.
  1. לוחצים על עריכה .
  2. לצד שירותים לוחצים על 'הוספת שירות'. .
  3. יש לבחור באחת מהאפשרויות הבאות API של Google Docs ולוחצים על Add.

הרצת הדוגמה

בעורך Apps Script, לוחצים על Run.

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

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

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

השלבים הבאים