क्या आपके उपयोगकर्ता, Google Meet के साथ Classroom का इस्तेमाल कर रहे हैं? ऐप्लिकेशन स्क्रिप्ट की मदद से, 'Google Meet कोर्स' में छात्र-छात्राओं की मौजूदगी जानने का तरीका जानें.

पाठ्यक्रम और ग्रेड प्रबंधित करें

Classroom के यूज़र इंटरफ़ेस (यूआई), पांच तरह के क्लासवर्क के साथ काम करते हैं: असाइनमेंट, क्विज़ असाइनमेंट, छोटे जवाब वाले सवाल, और सामग्री. फ़िलहाल, Classroom API में इस तरह के तीन विकल्प उपलब्ध हैं. इन्हें एपीआई के लिए, CourseWorkType के तौर पर जाना जाता है: Assignments, छोटे जवाब, और कई विकल्प वाले सवाल.

.

इस सुविधा को ऐक्सेस करने के लिए, CourseWork रिसॉर्स का इस्तेमाल किया जा सकता है. यह असाइनमेंट या सवाल को दिखाता है जो किसी खास कोर्स में छात्र/छात्राओं को असाइन किया जाता है. इसमें, पूरा होने की तारीख या मैक्स स्कोर जैसे अन्य कॉन्टेंट और जानकारी भी शामिल होती है.

CourseWork संसाधन के अलावा, आप पूरे किए गए असाइनमेंट StudentSubmission संसाधन से मैनेज कर सकते हैं. इन सेक्शन में, इनके बारे में ज़्यादा जानकारी दी गई है.

असाइनमेंट बनाना

सिर्फ़ कोर्स के शिक्षक की ओर से असाइनमेंट बनाए जा सकते हैं और छात्र/छात्रा की ओर से कोर्स बनाने की कोशिश करने पर 403 PERMISSION_DENIED वाली गड़बड़ी हो सकती है. इसी तरह, डोमेन एडमिन उन कोर्स के लिए भी असाइनमेंट नहीं बना सकते जिन्हें वे पढ़ाते नहीं हैं और एपीआई की मदद से ऐसा करने की कोशिश करते हैं. इसकी वजह से 403 PERMISSION_DENIED गड़बड़ी भी हो सकती है.

courses.courseWork.create तरीके का इस्तेमाल करके असाइनमेंट बनाते समय, लिंक को materials के तौर पर अटैच किया जा सकता है, जैसा कि नीचे दिए गए सैंपल कोड में दिखाया गया है:

Java

class/snippets/src/main/java/CreateCourseWork.java
CourseWork courseWork = null;
try {
  // Create a link to add as a material on course work.
  Link articleLink =
      new Link()
          .setTitle("SR-71 Blackbird")
          .setUrl("https://www.lockheedmartin.com/en-us/news/features/history/blackbird.html");

  // Create a list of Materials to add to course work.
  List<Material> materials = Arrays.asList(new Material().setLink(articleLink));

  /* Create new CourseWork object with the material attached.
  Set workType to `ASSIGNMENT`. Possible values of workType can be found here:
  https://developers.google.com/classroom/reference/rest/v1/CourseWorkType
  Set state to `PUBLISHED`. Possible values of state can be found here:
  https://developers.google.com/classroom/reference/rest/v1/courses.courseWork#courseworkstate */
  CourseWork content =
      new CourseWork()
          .setTitle("Supersonic aviation")
          .setDescription(
              "Read about how the SR-71 Blackbird, the world’s fastest and "
                  + "highest-flying manned aircraft, was built.")
          .setMaterials(materials)
          .setWorkType("ASSIGNMENT")
          .setState("PUBLISHED");

  courseWork = service.courses().courseWork().create(courseId, content).execute();

  /* Prints the created courseWork. */
  System.out.printf("CourseWork created: %s\n", courseWork.getTitle());
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The courseId does not exist: %s.\n", courseId);
  } else {
    throw e;
  }
  throw e;
} catch (Exception e) {
  throw e;
}
return courseWork;

Python

Classroom/snippets/classroom_create_coursework.py
from __future__ import print_function

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def classroom_create_coursework(course_id):

    """
    Creates the coursework the user has access to.
    Load pre-authorized user credentials from the environment.
    TODO(developer) - See https://developers.google.com/identity
    for guides on implementing OAuth2 for the application.
    """

    creds, _ = google.auth.default()
    # pylint: disable=maybe-no-member

    try:
        service = build('classroom', 'v1', credentials=creds)
        coursework = {
            'title': 'Ant colonies',
            'description': '''Read the article about ant colonies
                              and complete the quiz.''',
            'materials': [
                {'link': {'url': 'http://example.com/ant-colonies'}},
                {'link': {'url': 'http://example.com/ant-quiz'}}
            ],
            'workType': 'ASSIGNMENT',
            'state': 'PUBLISHED',
        }
        coursework = service.courses().courseWork().create(
            courseId=course_id, body=coursework).execute()
        print(f"Assignment created with ID {coursework.get('id')}")
        return coursework

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error


if __name__ == '__main__':
    # Put the course_id of course whose coursework needs to be created,
    # the user has access to.
    classroom_create_coursework(453686957652)

इस नतीजे में सर्वर से असाइन किया गया आइडेंटिफ़ायर शामिल होता है. इसका इस्तेमाल, दूसरे एपीआई अनुरोधों में असाइनमेंट का रेफ़रंस देने के लिए किया जा सकता है.

Classroom API की मदद से बनाए गए असाइनमेंट में, लिंक किए गए कॉन्टेंट को शामिल करने के लिए, लिंक संसाधन का इस्तेमाल करें. इसके लिए, टारगेट यूआरएल की जानकारी दें. Classroom अपने-आप शीर्षक और थंबनेल इमेज को फ़ेच करता है. Classroom API, मूल रूप से Google Drive और YouTube कॉन्टेंट के साथ भी काम करता है. यह DriveFile रिसॉर्स या YouTubeVideo रिसॉर्स की मदद से भी किया जा सकता है.

पूरा होने की तारीख बताने के लिए, dueDate और dueTime फ़ील्ड को संबंधित यूटीसी समय पर सेट करें. अनुमति देने की आखिरी तारीख, आने वाले समय की होनी चाहिए.

असाइनमेंट और सवालों के जवाब पाएं

आप मिलते-जुलते कोर्स के छात्र/छात्राओं और शिक्षकों के लिए, असाइनमेंट और सवाल पा सकते हैं. इसके अलावा, आप इसे किसी डोमेन एडमिन के ज़रिए भी वापस पा सकते हैं. किसी खास असाइनमेंट या सवाल को फिर से पाने के लिए, Course.courseWork.get का इस्तेमाल करें. सभी असाइनमेंट या सवालों को फिर से पाने के लिए (वैकल्पिक तौर पर कुछ मानदंड से मेल खाने वाला) Course.courseWork.list का इस्तेमाल करें.

ज़रूरी दायरा, अनुरोध करने वाले उपयोगकर्ता की भूमिका पर निर्भर करता है. अगर उपयोगकर्ता छात्र/छात्रा है, तो इनमें से किसी एक दायरे का इस्तेमाल करें:

  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me

अगर उपयोगकर्ता एक शिक्षक या डोमेन एडमिन है, तो इनमें से किसी एक स्कोप का इस्तेमाल करें:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students

किसी असाइनमेंट या सवाल को फिर से पाने की अनुमति लेने का मतलब यह नहीं है कि आपके पास सामग्री या सामग्री का मेटाडेटा ऐक्सेस करने की अनुमतियां हैं. व्यावहारिक तौर पर, इसका मतलब है कि अगर एडमिन, कोर्स की सदस्य नहीं हैं, तो हो सकता है कि उन्हें, अटैच की गई Drive फ़ाइल का शीर्षक न दिखे. अगर आप एडमिन को उपयोगकर्ता फ़ाइलों का ऐक्सेस देना चाहते हैं, तो पूरे डोमेन पर काम का ऐक्सेस गाइड देखें.

छात्र-छात्राओं के जवाब मैनेज करें

StudentSubmission संसाधन से पता चलता है कि किसी छात्र/छात्रा को असाइनमेंट या सवाल के लिए किए गए काम और उनके ग्रेड क्या हैं. StudentSubmission एक नया सवाल या असाइनमेंट बनाए जाने पर, हर छात्र/छात्रा के लिए संसाधन को एक तरीके से बनाया जाता है.

नीचे दिए गए सेक्शन में, छात्र-छात्राओं के जवाबों को मैनेज करने से जुड़ी सामान्य कार्रवाइयों के बारे में बताया गया है.

छात्र-छात्राओं के जवाब वापस पाएं

छात्र-छात्राएं अपने सबमिशन को फिर से पा सकते हैं, शिक्षक अपने कोर्स के सभी छात्र-छात्राओं के लिए सबमिट किए गए असाइनमेंट फिर से पा सकते हैं और डोमेन एडमिन अपने डोमेन के सभी छात्र-छात्राओं के सभी असाइनमेंट सबमिट कर सकते हैं. हर छात्र/छात्रा के सबमिशन को एक आइडेंटिफ़ायर असाइन किया जाता है. अगर आपको आइडेंटिफ़ायर की जानकारी है, तो उसे वापस पाने के लिए courses.courseWork.studentSubmissions.get का इस्तेमाल करें.

courses.courseWork.studentSubmissions.list मैथड का इस्तेमाल करके StudentSubmission रिसॉर्स पाएं, जो कुछ मानदंडों से मेल खाते हैं. जैसा कि यहां दिए गए सैंपल में दिखाया गया है:

Java

class/snippets/src/main/java/ListSubmissions.java
List<StudentSubmission> studentSubmissions = new ArrayList<>();
String pageToken = null;

try {
  do {
    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 submission found.");
  } else {
    for (StudentSubmission submission : studentSubmissions) {
      System.out.printf(
          "Student id (%s), student submission id (%s)\n",
          submission.getUserId(), submission.getId());
    }
  }
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf(
        "The courseId (%s) or courseWorkId (%s) does not exist.\n", courseId, courseWorkId);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return studentSubmissions;

Python

Classroom/snippets/classroom_list_submissions.py
from __future__ import print_function

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def classroom_list_submissions(course_id, coursework_id):
    """
    Creates the courses the user has access to.
    Load pre-authorized user credentials from the environment.
    TODO(developer) - See https://developers.google.com/identity
    for guides on implementing OAuth2 for the application.
    """

    creds, _ = google.auth.default()
    # pylint: disable=maybe-no-member
    submissions = []
    page_token = None

    try:
        service = build('classroom', 'v1', credentials=creds)
        while True:
            coursework = service.courses().courseWork()
            response = coursework.studentSubmissions().list(
                pageToken=page_token,
                courseId=course_id,
                courseWorkId=coursework_id,
                pageSize=10).execute()
            submissions.extend(response.get('studentSubmissions', []))
            page_token = response.get('nextPageToken', None)
            if not page_token:
                break

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

        print('Student Submissions:')
        for submission in submissions:
            print(f"Submitted at:"
                  f"{(submission.get('id'), submission.get('creationTime'))}")

    except HttpError as error:
        print(f"An error occurred: {error}")
        submissions = None
    return submissions


if __name__ == '__main__':
    # Put the course_id and coursework_id of course whose list needs to be
    # submitted.
    classroom_list_submissions(453686957652, 466086979658)

userId सैंपल की जानकारी देकर, किसी खास छात्र/छात्रा से जुड़े StudentSubmission रिसॉर्स फिर से पाएं, जैसा कि इस सैंपल में दिखाया गया है:

Java

class/snippets/src/main/java/ListStudentSubmissions.java
List<StudentSubmission> studentSubmissions = new ArrayList<>();
String pageToken = null;

try {
  do {
    // Set the userId as a query parameter on the request.
    ListStudentSubmissionsResponse response =
        service
            .courses()
            .courseWork()
            .studentSubmissions()
            .list(courseId, courseWorkId)
            .setPageToken(pageToken)
            .set("userId", userId)
            .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 submission found.");
  } else {
    for (StudentSubmission submission : studentSubmissions) {
      System.out.printf("Student submission: %s.\n", submission.getId());
    }
  }

Python

classs/snippets/classroom_list_student_submissions.py
from __future__ import print_function

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def classroom_list_student_submissions(course_id, coursework_id, user_id):
    """
    Creates the courses the user has access to.
    Load pre-authorized user credentials from the environment.
    TODO(developer) - See https://developers.google.com/identity
    for guides on implementing OAuth2 for the application.
    """

    creds, _ = google.auth.default()
    # pylint: disable=maybe-no-member
    submissions = []
    page_token = None

    try:
        service = build('classroom', 'v1', credentials=creds)
        while True:
            coursework = service.courses().courseWork()
            response = coursework.studentSubmissions().list(
                pageToken=page_token,
                courseId=course_id,
                courseWorkId=coursework_id,
                userId=user_id).execute()
            submissions.extend(response.get('studentSubmissions', []))
            page_token = response.get('nextPageToken', None)
            if not page_token:
                break

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

        print('Student Submissions:')
        for submission in submissions:
            print(f"Submitted at:"
                  f"{(submission.get('id'), submission.get('creationTime'))}")

    except HttpError as error:
        print(f"An error occurred: {error}")
    return submissions


if __name__ == '__main__':
    # Put the course_id, coursework_id and user_id of course whose list needs
    # to be submitted.
    classroom_list_student_submissions(453686957652, 466086979658, "me")

छात्र/छात्रा की पहचान, उपयोगकर्ता के यूनीक आईडी या ईमेल पते से की जाती है, जैसा कि Google Admin SDK टूल ने दिया है. मौजूदा उपयोगकर्ता "me" शॉर्टहैंड का इस्तेमाल करके अपना आईडी भी देख सकता है.

कोर्स के अंदर ही सभी असाइनमेंट के लिए छात्र/छात्रा के सबमिशन भी लिए जा सकते हैं. ऐसा करने के लिए, लिटरल "-" का इस्तेमाल courseWorkId के तौर पर करें, जैसा कि इस सैंपल में दिखाया गया है:

Java

service.courses().courseWork().studentSubmissions()
    .list(courseId, "-")
    .set("userId", userId)
    .execute();

Python

service.courses().courseWork().studentSubmissions().list(
    courseId=<course ID or alias>,
    courseWorkId='-',
    userId=<user ID>).execute()

ज़रूरी दायरा, अनुरोध करने वाले उपयोगकर्ता की भूमिका पर निर्भर करता है. अगर उपयोगकर्ता शिक्षक या डोमेन एडमिन है, तो इस दायरे का इस्तेमाल करें:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students

अगर उपयोगकर्ता छात्र/छात्रा है, तो इस दायरे का इस्तेमाल करें:

  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me

छात्र/छात्रा के सबमिशन को वापस लाने की अनुमति मिलने पर, अटैचमेंट या अटैचमेंट मेटाडेटा को ऐक्सेस करने की अनुमति नहीं मिलती है. व्यावहारिक तौर पर, इसका मतलब है कि अगर एडमिन, कोर्स की सदस्यता नहीं है, तो हो सकता है कि अटैच की गई Drive फ़ाइल का शीर्षक न दिखे. अगर आप एडमिन को उपयोगकर्ता फ़ाइलों का ऐक्सेस देना चाहते हैं, तो पूरे डोमेन पर सौंपना गाइड देखें.

छात्र/छात्रा के जवाब में अटैचमेंट जोड़ना

Link, DriveFile या YouTubeVideo रिसॉर्स को अटैच करके, छात्र/छात्रा के सबमिशन में लिंक अटैच किए जा सकते हैं. यह courses.courseWork.studentSubmissions.modifyAttachments के साथ किया जाता है, जैसा कि इस सैंपल में दिखाया गया है:

Java

classs/snippets/src/main/java/Modifiedअटैचमेंटछात्र सदस्यता
StudentSubmission studentSubmission = null;
try {
  // Create ModifyAttachmentRequest object that includes a new attachment with a link.
  Link link = new Link().setUrl("https://en.wikipedia.org/wiki/Irrational_number");
  Attachment attachment = new Attachment().setLink(link);
  ModifyAttachmentsRequest modifyAttachmentsRequest =
      new ModifyAttachmentsRequest().setAddAttachments(Arrays.asList(attachment));

  // The modified studentSubmission object is returned with the new attachment added to it.
  studentSubmission =
      service
          .courses()
          .courseWork()
          .studentSubmissions()
          .modifyAttachments(courseId, courseWorkId, id, modifyAttachmentsRequest)
          .execute();

  /* Prints the modified student submission. */
  System.out.printf(
      "Modified student submission attachments: '%s'.\n",
      studentSubmission.getAssignmentSubmission().getAttachments());
} 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;

Python

Classroom/snippets/classroom_add_attachment.py

def classroom_add_attachment(course_id, coursework_id, submission_id):
    """
    Adds attachment to existing course with specific course_id.
    Load pre-authorized user credentials from the environment.
    TODO(developer) - See https://developers.google.com/identity
    for guides on implementing OAuth2 for the application.
    """
    creds, _ = google.auth.default()
    # pylint: disable=maybe-no-member
    request = {
        'addAttachments': [
            {'link': {'url': 'http://example.com/quiz-results'}},
            {'link': {'url': 'http://example.com/quiz-reading'}}
        ]
    }

    try:
        service = build('classroom', 'v1', credentials=creds)
        while True:
            coursework = service.courses().courseWork()
            coursework.studentSubmissions().modifyAttachments(
                courseId=course_id,
                courseWorkId=coursework_id,
                id=submission_id,
                body=request).execute()

    except HttpError as error:
        print(f"An error occurred: {error}")


if __name__ == '__main__':
    # Put the course_id, coursework_id and submission_id of course in which
    # attachment needs to be added.
    classroom_add_attachment('course_id', 'coursework_id', "me")

लिंक अटैचमेंट को टारगेट यूआरएल के ज़रिए तय किया जाता है; Classroom अपने-आप शीर्षक और थंबनेल इमेज को फ़ेच करेगा. बाकी कॉन्टेंट के बारे में जानकारी पाने के लिए, उनकी जानकारी वाले पेजों पर जाएं.

StudentSubmission में सिर्फ़ कोर्स का शिक्षक या उसका मालिक बदलाव कर सकता है. छात्र/छात्रा के सबमिशन का CourseWorkType सिर्फ़ ASSIGNMENT होने पर ही, Materials अटैच किया जा सकता है.

ज़रूरी दायरा, अनुरोध करने वाले उपयोगकर्ता की भूमिका पर निर्भर करता है. अगर उपयोगकर्ता कोई शिक्षक है, तो इस तरीके का इस्तेमाल करें:

  • https://www.googleapis.com/auth/classroom.coursework.students

अगर उपयोगकर्ता छात्र/छात्रा है, तो इस दायरे का इस्तेमाल करें:

  • https://www.googleapis.com/auth/classroom.coursework.me

छात्र/छात्रा के जवाब की स्थिति मैनेज करें

छात्र/छात्रा का जवाब अनसबमिट किया जा सकता है, सबमिट किया जा सकता है या वापस किया जा सकता है. StudentSubmission में राज्य का फ़ील्ड मौजूदा स्थिति दिखाता है. स्टेटस बदलने के लिए, इनमें से किसी एक तरीके का इस्तेमाल करें:

ये सभी तरीके खाली होते हैं. उदाहरण:

Java

classs/snippets/src/main/java/RETURNStudentSubmission.java
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;
}

Python

service.courses().courseWork().studentSubmission().turnIn(
    courseId=<course ID or alias>,
    courseWorkId=<courseWork ID>,
    id=<studentSubmission ID>,
    body={}).execute()

जिस छात्र/छात्रा के पास StudentSubmission का मालिकाना हक है सिर्फ़ वह उसे सबमिट कर सकता है या उसका दावा कर सकता है. सिर्फ़ सबमिट किए गए सबमिशन पर फिर से दावा किया जा सकता है. कोर्स की टीचर, सिर्फ़ वही StudentSubmission दिखा सकती हैं जो मोड में है.

छात्र/छात्रा के ग्रेड

StudentSubmission संसाधन में ग्रेड स्टोर करने के लिए दो फ़ील्ड होते हैं: assignedGrade, जो छात्र-छात्राओं को रिपोर्ट किया जाता है और draftGrade, यह ऐसा अस्थायी ग्रेड होता है जो सिर्फ़ शिक्षकों को दिखता है. नीचे दिए गए नमूने में दिखाए गए तरीके से, सही फ़ील्ड वाले फ़ील्ड मास्क के साथ courses.courseWork.studentSubmissions.patch का इस्तेमाल करके इन फ़ील्ड को अपडेट किया जाता है.

Java

class/snippets/src/main/java/Patch StudentsSubmission.java
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;

Python

studentSubmission = {
  'assignedGrade': 99,
  'draftGrade': 80
}
service.courses().courseWork().studentSubmissions().patch(
    courseId=<course ID or alias>,
    courseWorkId=<courseWork ID>,
    id=<studentSubmission ID>,
    updateMask='assignedGrade,draftGrade',
    body=studentSubmission).execute()

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

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

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

असाइन किए गए ग्रेड की सूची बनाएं

courses.courseWork.studentSubmissions.list मैथड के रिस्पॉन्स ऑब्जेक्ट को एक्सप्लोर करके, किसी खास क्लासवर्क के आइटम के सभी ग्रेड दिए जा सकते हैं:

Java

class/snippets/src/main/java/ListStudentSubmissions.java
  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());
  }
}

Python

response = coursework.studentSubmissions().list(
    courseId=course_id,
    courseWorkId=coursework_id,
    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'))}")