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

مدیریت دوره‌ها و فهرست‌ها.

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

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

مرجع

برای اطلاعات دقیق در مورد این سرویس، به مستندات مرجع Classroom API مراجعه کنید. مانند تمام سرویس‌های پیشرفته در Apps Script، سرویس Classroom از همان اشیاء، متدها و پارامترهای 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);
  }
}