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

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

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

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

מטרות

  • יוצרים את הסקריפט.
  • מפעילים את ממשק 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(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. לוחצים על ללא שם, מקלידים Quickstart ולוחצים על Rename.

הפעלת Google Docs API

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

הרצת הדוגמה

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

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

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

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

השלבים הבאים