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

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

مَراجع

للحصول على معلومات تفصيلية حول هذه الخدمة، اطّلِع على المستندات المرجعية الخاصة بواجهة Google Classroom API. مثل جميع الخدمات المتقدمة في لغة برمجة التطبيقات، تستخدم خدمة 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);
  }
}