कक्षा सेवा

Classroom सेवा की मदद से, Google Apps Script में Google Classroom API का इस्तेमाल किया जा सकता है. इस एपीआई की मदद से, एडमिन, शिक्षक, और छात्र-छात्राएं अपने कोर्स और रोस्टर देख और मैनेज कर सकते हैं.

यह एक अडवांस सेवा है. इसका इस्तेमाल करने से पहले, इसे चालू करना ज़रूरी है. इसे चालू करने के बारे में सिलसिलेवार निर्देश पाने के लिए, क्विकस्टार्ट गाइड देखें.

संदर्भ

इस सेवा के बारे में ज़्यादा जानकारी पाने के लिए, 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);
  }
}