Method: courses.courseWork.addOnAttachments.studentSubmissions.patch

Updates data associated with an add-on attachment submission.

Requires the add-on to have been the original creator of the attachment and the attachment to have a positive maxPoints value set.

This method returns the following error codes:

  • PERMISSION_DENIED for access errors.
  • INVALID_ARGUMENT if the request is malformed.
  • NOT_FOUND if one of the identified resources does not exist.

HTTP request

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
courseId

string

Required. Identifier of the course.
itemId

string

Identifier of the Announcement, CourseWork, or CourseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from postId.
attachmentId

string

Required. Identifier of the attachment.
submissionId

string

Required. Identifier of the student's submission.

Query parameters

Parameters
postId
(deprecated)

string

Optional. Deprecated, use itemId instead.
updateMask

string (FieldMask format)

Required. Mask that identifies which fields on the attachment to update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the AddOnAttachmentStudentSubmission object.

The following fields may be specified by teachers:

  • pointsEarned

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body contains an instance of AddOnAttachmentStudentSubmission.

Response body

If successful, the response body contains an instance of AddOnAttachmentStudentSubmission.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/classroom.addons.teacher

For more information, see the Authorization guide.