سرویس کلاس درس

سرویس Classroom به شما امکان می‌دهد از API کلاس درس گوگل در Apps Script استفاده کنید. این API به مدیران، معلمان و دانش‌آموزان این امکان را می‌دهد که دوره‌ها و فهرست‌های خود را مشاهده و مدیریت کنند.

مرجع

برای اطلاعات دقیق در مورد این سرویس، به مستندات مرجع برای API کلاس درس گوگل مراجعه کنید. مانند تمام سرویس‌های پیشرفته در Apps Script، سرویس کلاس درس از همان اشیاء، متدها و پارامترهای API عمومی استفاده می‌کند. برای اطلاعات بیشتر، به بخش «نحوه تعیین امضاهای متد» مراجعه کنید.

برای گزارش مشکلات و یافتن پشتیبانی‌های دیگر، به راهنمای پشتیبانی کلاس درس مراجعه کنید.

کد نمونه

کد نمونه زیر از نسخه ۱ این API استفاده می‌کند.

لیست دوره‌ها

این نمونه، ده دوره اولی را که کاربر به آنها دسترسی دارد، فهرست می‌کند.

پیشرفته/کلاس درس.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);
  }
}