שירות Classroom

שירות Classroom מאפשר לכם להשתמש ב-Google Classroom API ב-Apps Script. ממשק ה-API הזה מאפשר לאדמינים, למורים ולתלמידים להציג ולנהל את הקורסים ואת רשימות התלמידים שלהם.

הערה: זהו שירות מתקדם שצריך להפעיל לפני שמשתמשים בו. במדריך למתחילים מפורטות הוראות מפורטות לתחילת העבודה.

חומרי עזר

למידע מפורט על השירות הזה, קראו את מאמרי העזרה של Google Classroom API. כמו כל השירותים המתקדמים ב-Apps Script, השירות של Classroom משתמש באותם אובייקטים, שיטות ופרמטרים כמו ה-API הציבורי. מידע נוסף זמין במאמר איך נקבעות חתימות השיטות.

במדריך התמיכה של Classroom מוסבר איך לדווח על בעיות ולקבל תמיכה נוספת.

קוד לדוגמה

בקוד לדוגמה שבהמשך נעשה שימוש בגרסה 1 של ה-API.

הצגת רשימה של קורסים

בדוגמה הזו מפורטים עשרת הקורסים הראשונים שיש למשתמש גישה אליהם.

advanced/classroom.gs

הצגת הקוד ב-GitHub

/**
 * Lists 10 course names and IDs.
 */
function listCourses() {
  /**
   * @see https://developers.google.com/classroom/reference/rest/v1/courses/list
   */
  const optionalArgs = {
    pageSize: 10
    // Use other query parameters here if needed.
  };
  try {
    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 available courses.
    for (const course in courses) {
      console.log('%s (%s)', courses[course].name, courses[course].id);
    }
  } catch (err) {
    // TODO (developer)- Handle Courses.list() exception from Classroom API
    console.log('Failed with error %s', err.message);
  }
}