מדריך למתחילים ב-Google Apps Script

יוצרים Google Apps Script שמבצע בקשות ל-API של יומן Google.

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

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

מטרות

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

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

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

  • גישה ל-Google Drive

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

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

calendar/quickstart/quickstart.gs
/**
 * Lists 10 upcoming events in the user's calendar.
 * @see https://developers.google.com/calendar/api/v3/reference/events/list
 */
function listUpcomingEvents() {
  const calendarId = "primary";
  // Add query parameters in optionalArgs
  const optionalArgs = {
    timeMin: new Date().toISOString(),
    showDeleted: false,
    singleEvents: true,
    maxResults: 10,
    orderBy: "startTime",
    // use other optional query parameter here as needed.
  };
  try {
    // call Events.list method to list the calendar events using calendarId optional query parameter
    const response = Calendar.Events.list(calendarId, optionalArgs);
    const events = response.items;
    if (events.length === 0) {
      console.log("No upcoming events found");
      return;
    }
    // Print the calendar events
    for (const event of events) {
      let when = event.start.dateTime;
      if (!when) {
        when = event.start.date;
      }
      console.log("%s (%s)", event.summary, when);
    }
  } catch (err) {
    // TODO (developer) - Handle exception from Calendar API
    console.log("Failed with error %s", err.message);
  }
}

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

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

הפעלת יומן Google API

פותחים את פרויקט Apps Script.

  1. לוחצים על עריכה .
  2. לצד שירותים, לוחצים על סמל הוספת שירות .
  3. בוחרים באפשרות Calendar API (ממשק API של יומן Google) ולוחצים על הוספה.

מריצים את הדוגמה

בעורך Apps Script, לוחצים על Run (הפעלה).

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

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

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

השלבים הבאים