خدمة الفصول الدراسية

إدارة الدورات التدريبية وقوائم الطلاب المسجّلين

تتيح لك خدمة Classroom استخدام Google Classroom API في Google Apps Script. تتيح واجهة برمجة التطبيقات هذه للمشرفين والمعلّمين والطلاب عرض دوراتهم التدريبية وقوائم الطلاب وإدارتها.

هذه خدمة متقدّمة يجب تفعيلها قبل الاستخدام. اتّبِع دليل البدء السريع للحصول على تعليمات مفصّلة حول كيفية البدء.

مراجع

للحصول على معلومات تفصيلية عن هذه الخدمة، يُرجى الاطّلاع على المستندات المرجعية الخاصة بـ Classroom API. مثل جميع الخدمات المتقدّمة في Apps Script، تستخدم خدمة Classroom العناصر والطرق والمعلَمات نفسها التي تستخدمها واجهة برمجة التطبيقات العامة. لمزيد من المعلومات، اطّلِع على كيفية تحديد التواقيع.

للإبلاغ عن المشاكل والعثور على دعم آخر، يُرجى الاطّلاع على دليل دعم Classroom.

نموذج التعليمات البرمجية

يستخدم نموذج الرمز التالي الإصدار 1 من واجهة برمجة التطبيقات.

عرض قائمة بالدورات التدريبية

تعرض هذه العيّنة أول عشر دورات تدريبية يمكن للمستخدم الوصول إليها.

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);
  }
}