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

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

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

יוצרים סקריפט של Google Apps ששולח בקשות ל-Google Classroom API.

מטרות

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

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

  • חשבון Google for Education שהופעל בו Google Classroom.

  • גישה ל-Google Drive

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

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

classroom/quickstart/quickstart.gs
/**
 * Lists 10 course names and ids.
 */
function listCourses() {
  /**  here pass pageSize Query parameter as argument to get maximum number of result
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10
    // Use other parameter here if needed
  };
  try {
    // call courses.list() method to list the courses in classroom
    const response = Classroom.Courses.list(optionalArgs);
    const courses = response.courses;
    if (!courses || courses.length === 0) {
      console.log('No courses found.');
      return;
    }
    // Print the course names and IDs of the courses
    for (const course of courses) {
      console.log('%s (%s)', course.name, course.id);
    }
  } catch (err) {
    // TODO (developer)- Handle Courses.list() exception from Classroom API
    // get errors like PERMISSION_DENIED/INVALID_ARGUMENT/NOT_FOUND
    console.log('Failed with error %s', err.message);
  }
}

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

הפעלת Google Classroom API

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

הרצת הדוגמה

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

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

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

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

השלבים הבאים