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

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

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

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

מטרות

  • יוצרים את הסקריפט.
  • מפעילים את Google Tasks API.
  • מריצים את הדוגמה.

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

  • חשבון Google שהופעל בו משימות Google.

  • גישה ל-Google Drive

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

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

tasks/quickstart/quickstart.gs
/**
 * Lists the user's tasks.
 * @see https://developers.google.com/tasks/reference/rest/v1/tasklists/list
 */
function listTaskLists() {
  const optionalArgs = {
    maxResults: 10
  };
  try {
    // Returns all the authenticated user's task lists.
    const response = Tasks.Tasklists.list(optionalArgs);
    const taskLists = response.items;
    // Print task list of user if available.
    if (!taskLists || taskLists.length === 0) {
      console.log('No task lists found.');
      return;
    }
    for (const taskList of taskLists) {
      console.log('%s (%s)', taskList.title, taskList.id);
    }
  } catch (err) {
    // TODO (developer) - Handle exception from Task API
    console.log('Failed with error %s', err.message);
  }
}

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

הפעלת Google Tasks API

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

הפעלת הדוגמה

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

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

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

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

השלבים הבאים