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

سرویس 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);
  }
}