Patch v1coursescourseidcourseworkcourseworkidstudentsubmissionsid

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1310484273.7 KB

courses

Updates one or more fields of a student submission. See google.classroom.v1.StudentSubmission for details of which fields may be updated and who may change them. This request must be made by the Developer Console project of the OAuth client ID used to create the corresponding course work item. This method returns the following error codes: * PERMISSION_DENIED if the requesting developer project did not create the corresponding course work, if the user is not permitted to make the requested modification to the student submission, or for access errors. * INVALID_ARGUMENT if the request is malformed. * NOT_FOUND if the requested course, course work, or student submission does not exist.

patch/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}

Path parameters

courseIdstring required

Identifier of the course. This identifier can be either the Classroom-assigned identifier or an alias.

courseWorkIdstring required

Identifier of the course work.

idstring required

Identifier of the student submission.

Query parameters

updateMaskstring

Mask that identifies which fields on the student submission to update. This field is required to do an update. The update fails if invalid fields are specified. The following fields may be specified by teachers: * draft_grade * assigned_grade

Request body

idstring

Classroom-assigned Identifier for the student submission. This is unique among submissions for the relevant course work. Read-only.

creationTimestring google-datetime

Creation time of this submission. This may be unset if the student has not accessed this item. Read-only.

courseWorkType'COURSE_WORK_TYPE_UNSPECIFIED' | 'ASSIGNMENT' | 'SHORT_ANSWER_QUESTION' | 'MULTIPLE_CHOICE_QUESTION'

Type of course work this submission is for. Read-only.

draftRubricGradesobject

Pending rubric grades based on the rubric's criteria. This map is empty if there is no rubric attached to this course work or if a rubric is attached, but no grades have been set on any criteria. Entries are only populated for grades that have been set. Key: The rubric's criterion ID. Read-only.

alternateLinkstring

Absolute link to the submission in the Classroom web UI. Read-only.

State of this submission. Read-only.

assignedGradenumber double

Optional grade. If unset, no grade was set. This value must be non-negative. Decimal (that is, non-integer) values are allowed, but are rounded to two decimal places. This may be modified only by course teachers.

associatedWithDeveloperboolean

Whether this student submission is associated with the Developer Console project making the request. See CreateCourseWork for more details. Read-only.

userIdstring

Identifier for the student that owns this submission. Read-only.

updateTimestring google-datetime

Last update time of this submission. This may be unset if the student has not accessed this item. Read-only.

lateboolean

Whether this submission is late. Read-only.

assignedRubricGradesobject

Assigned rubric grades based on the rubric's Criteria. This map is empty if there is no rubric attached to this course work or if a rubric is attached, but no grades have been set on any Criteria. Entries are only populated for grades that have been set. Key: The rubric's criterion ID. Read-only.

courseIdstring

Identifier of the course. Read-only.

courseWorkIdstring

Identifier for the course work this corresponds to. Read-only.

draftGradenumber double

Optional pending grade. If unset, no grade was set. This value must be non-negative. Decimal (that is, non-integer) values are allowed, but are rounded to two decimal places. This is only visible to and modifiable by course teachers.

Response

Successful response