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

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

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

مراجع

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

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

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

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

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

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

advanced/classroom.gs

عرض على GitHub

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