שירות Classroom

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

חומר עזר

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

כדי לדווח על בעיות ולמצוא תמיכה אחרת, קראו את מדריך התמיכה ב-Classroom.

קוד לדוגמה

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

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

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

advanced/classroom.gs
/**
 * 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);
  }
}