הפעלה מהירה של הסקריפט של Google Apps

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

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

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

מטרות

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

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

  • דומיין ב-Google Workspace שבהם מופעלת גישה ל-API.
  • חשבון Google בדומיין הזה עם הרשאות אדמין.

  • גישה ל-Google Drive

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

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

adminSDK/reports/quickstart.gs
/**
 * List login events for a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list
 */
function listLogins() {
  const userKey = 'all';
  const applicationName = 'login';
  const optionalArgs = {
    maxResults: 10
  };
  try {
    const response = AdminReports.Activities.list(userKey, applicationName, optionalArgs);
    const activities = response.items;
    if (!activities || activities.length === 0) {
      console.log('No logins found.');
      return;
    }
    // Print login events
    console.log('Logins:');
    for (const activity of activities) {
      console.log('%s: %s (%s)', activity.id.time, activity.actor.email,
          activity.events[0].name);
    }
  } catch (err) {
    // TODO (developer)- Handle exception from the Report  API
    console.log('Failed with error %s', err.message);
  }
}

  1. לוחצים על 'שמירה' .
  2. לוחצים על ללא שם, מקלידים Quickstart ולוחצים על Rename.

הפעלה של Admin SDK API

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

הרצת הדוגמה

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

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

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

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

השלבים הבאים