ग्रेड सेट करना और अपडेट करना

इस गाइड में, Classroom API के लिए ग्रेड से जुड़े कोड के उदाहरण दिए गए हैं. इस दस्तावेज़ में, Classroom में ग्रेड देने की प्रोसेस के मुख्य पहलुओं पर फ़ोकस किया गया है: StudentSubmission स्टेटस और ग्रेड मैनेज करना.

Classroom में ग्रेड देने के कॉन्सेप्ट के बारे में जानने के लिए, ग्रेड की गाइड पढ़ें.

StudentSubmission की स्थितियां मैनेज करना

StudentSubmission को सबमिट नहीं किया जा सकता, सबमिट किया जा सकता है या वापस किया जा सकता है. state फ़ील्ड, मौजूदा स्थिति दिखाता है. आम तौर पर, ग्रेड तब दिया जाता है, जब StudentSubmission की स्थिति TURNED_IN हो.

Classroom API का इस्तेमाल करके स्टेटस बदलने के लिए, इनमें से कोई एक तरीका अपनाएं:

• courses.courseWork.studentSubmissions.turnIn: सिर्फ़ वह छात्र या छात्रा ही StudentSubmission सबमिट कर सकता है जिसके पास यह है.
• courses.courseWork.studentSubmissions.reclaim: सिर्फ़ वह छात्र/छात्रा ही StudentSubmission पर दावा कर सकता है जिसके पास उसका मालिकाना हक है. सबमिशन को सिर्फ़ तब वापस पाया जा सकता है, जब उसे पहले ही सबमिट किया जा चुका हो.
• courses.courseWork.studentSubmissions.return: कोर्स में शामिल शिक्षक ही StudentSubmission का जवाब दे सकते हैं. सबमिशन को सिर्फ़ तब वापस लाया जा सकता है, जब छात्र/छात्रा ने उसे पहले ही सबमिट कर दिया हो.

ध्यान दें: इन एंडपॉइंट से अनुरोध करने पर, assignedGrade या draftGrade फ़ील्ड की वैल्यू सेट नहीं होती. अगले सेक्शन में, उन फ़ील्ड को सेट करने का तरीका बताया गया है.

ये सभी तरीके, खाली body पैरामीटर को स्वीकार करते हैं. इसका उदाहरण यहां दिया गया है:

Python

service.courses().courseWork().studentSubmission().turnIn(
    courseId=course_id,
    courseWorkId=coursework_id,
    id=studentsubmission_id,
    body={}).execute()

Java

classroom/snippets/src/main/java/ReturnStudentSubmission.java

GitHub पर देखना

try {
  service
      .courses()
      .courseWork()
      .studentSubmissions()
      .classroomReturn(courseId, courseWorkId, id, null)
      .execute();
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf(
        "The courseId (%s), courseWorkId (%s), or studentSubmissionId (%s) does "
            + "not exist.\n",
        courseId, courseWorkId, id);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}

छात्र-छात्राओं के सबमिशन के लिए ग्रेड सेट करना

StudentSubmission संसाधन में दो फ़ील्ड होते हैं. इनमें, ग्रेड वाले CourseWork काम के लिए पूरा ग्रेड सेव किया जाता है:

• draftGrade, एक संभावित ग्रेड है. यह सिर्फ़ शिक्षकों को दिखता है.
• assignedGrade वह ग्रेड है जो छात्र-छात्राओं को दिखाया जाता है.

इन फ़ील्ड को courses.courseWork.studentSubmissions.patch का इस्तेमाल करके अपडेट किया जाता है, जैसा कि यहां दिए गए उदाहरण में दिखाया गया है:

Python

studentSubmission = {
  'assignedGrade': 99,
  'draftGrade': 80
}

service.courses().courseWork().studentSubmissions().patch(
    courseId=course_id,
    courseWorkId=coursework_id,
    id=studentsubmission_id,
    updateMask='assignedGrade,draftGrade',
    body=studentSubmission).execute()

Java

classroom/snippets/src/main/java/PatchStudentSubmission.java

GitHub पर देखना

StudentSubmission studentSubmission = null;
try {
  // Updating the draftGrade and assignedGrade fields for the specific student submission.
  StudentSubmission content =
      service
          .courses()
          .courseWork()
          .studentSubmissions()
          .get(courseId, courseWorkId, id)
          .execute();
  content.setAssignedGrade(90.00);
  content.setDraftGrade(80.00);

  // The updated studentSubmission object is returned with the new draftGrade and assignedGrade.
  studentSubmission =
      service
          .courses()
          .courseWork()
          .studentSubmissions()
          .patch(courseId, courseWorkId, id, content)
          .set("updateMask", "draftGrade,assignedGrade")
          .execute();

  /* Prints the updated student submission. */
  System.out.printf(
      "Updated student submission draft grade (%s) and assigned grade (%s).\n",
      studentSubmission.getDraftGrade(), studentSubmission.getAssignedGrade());
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf(
        "The courseId (%s), courseWorkId (%s), or studentSubmissionId (%s) does "
            + "not exist.\n",
        courseId, courseWorkId, id);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return studentSubmission;

Classroom के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करते समय, शिक्षक तब तक assignedGrade सेट नहीं कर सकते, जब तक कि उन्होंने पहले draftGrade सेव नहीं कर लिया है. इसके बाद, assignedGrade को छात्र/छात्रा को वापस किया जा सकता है. आपका ऐप्लिकेशन, छात्र/छात्रा के असाइनमेंट को इनमें से किसी एक तरीके से ग्रेड दे सकता है:

• सिर्फ़ draftGrade असाइन करें. उदाहरण के लिए, यह सुविधा इस काम में मददगार होती है कि शिक्षक, ग्रेड तय करने से पहले उनकी मैन्युअल तौर पर समीक्षा कर सके. छात्र-छात्राएं ग्रेड के ड्राफ़्ट नहीं देख सकते.

• किसी असाइनमेंट को पूरा ग्रेड देने के लिए, draftGrade और assignedGrade, दोनों को असाइन करें.

कौनसा फ़ील्ड सेट करना है, यह कॉन्फ़िगर करने के लिए updateMask आर्ग्युमेंट का इस्तेमाल करें.

चेतावनी: draftGrade सेट किए बिना assignedGrade सेट न करें. सिर्फ़ assignedGrade को सेट करने पर, Classroom के यूज़र इंटरफ़ेस में अनचाहे नतीजे मिल सकते हैं.

StudentSubmissions में बदलाव करने के लिए ज़रूरी स्कोप और अनुमतियों को समझने के लिए, छात्र/छात्रा के जवाब में अटैचमेंट जोड़ना लेख पढ़ें.

असाइन किए गए ग्रेड देखना

किसी खास CourseWork के सभी ग्रेड ऐक्सेस करने के लिए, courses.courseWork.studentSubmissions.list तरीके का इस्तेमाल करके, उससे जुड़े सभी StudentSubmissions को वापस लाएं और सही assignedGrade और draftGrade फ़ील्ड की जांच करें:

Python

response = coursework.studentSubmissions().list(
    courseId=course_id,
    courseWorkId=coursework_id,
    # optionally include `pageSize` to restrict the number of student
    # submissions included in the response.
    pageSize=10
).execute()
submissions.extend(response.get('studentSubmissions', []))

if not submissions:
    print('No student submissions found.')

print('Student Submissions:')

for submission in submissions:
    print(f"Submitted at:"
          f"{(submission.get('userId'), submission.get('assignedGrade'))}")

Java

classroom/snippets/src/main/java/ListStudentSubmissions.java

GitHub पर देखना

  ListStudentSubmissionsResponse response =
      service
          .courses()
          .courseWork()
          .studentSubmissions()
          .list(courseId, courseWorkId)
          .setPageToken(pageToken)
          .execute();

  /* Ensure that the response is not null before retrieving data from it to avoid errors. */
  if (response.getStudentSubmissions() != null) {
    studentSubmissions.addAll(response.getStudentSubmissions());
    pageToken = response.getNextPageToken();
  }
} while (pageToken != null);

if (studentSubmissions.isEmpty()) {
  System.out.println("No student submissions found.");
} else {
  for (StudentSubmission submission : studentSubmissions) {
    System.out.printf(
        "User ID %s, Assigned grade: %s\n",
        submission.getUserId(), submission.getAssignedGrade());
  }
}

StudentSubmissions को पढ़ने के लिए ज़रूरी स्कोप और अनुमतियों को समझने के लिए, छात्र-छात्राओं के जवाब पाना लेख पढ़ें.

कोर्स के कुल ग्रेड तय करना

Classroom API की मदद से, डेवलपर को कोर्स के कुल ग्रेड को पढ़ने या उसमें बदलाव करने की अनुमति नहीं है. हालांकि, इसका हिसाब प्रोग्राम के हिसाब से लगाया जा सकता है. अगर आपको पूरे ग्रेड का हिसाब लगाना है, तो ग्रेड की गाइड पढ़ें. इससे आपको CourseWork, ग्रेड देने की अवधि, और ग्रेड देने के अलग-अलग सिस्टम जैसे अहम कॉन्सेप्ट को समझने में मदद मिलेगी.

ऐड-ऑन के अटैचमेंट को ग्रेड देना

अगर आप Classroom के ऐड-ऑन डेवलपर हैं, तो आपके पास अलग-अलग ऐड-ऑन अटैचमेंट के लिए ग्रेड सेट करने का विकल्प होता है. साथ ही, ग्रेड को इस तरह कॉन्फ़िगर किया जा सकता है कि जब शिक्षक छात्र-छात्राओं के काम की समीक्षा करें, तो उन्हें ग्रेड दिखे. ज़्यादा जानकारी के लिए, गतिविधि के टाइप के अटैचमेंट और ग्रेड पासबैक के बारे में जानकारी देने वाली गाइड देखें.

रूब्रिक के ग्रेड

StudentSubmissions में ऐसे फ़ील्ड होते हैं जिनमें Rubrics के आधार पर दिए गए स्कोर दिखते हैं:

• draftRubricGrade, Criterion के स्कोर का एक संभावित सेट है. यह सिर्फ़ शिक्षकों को दिखता है.
• assignedRubricGrade, Criterion स्कोर का वह सेट होता है जो छात्र-छात्राओं को दिखाया जाता है.

Google Classroom API का इस्तेमाल करके, रूब्रिक के स्कोर सेट नहीं किए जा सकते. हालांकि, उन्हें पढ़ा जा सकता है. ज़्यादा जानने के लिए, रubrics गाइड और सीमाएं देखें.