educationSubmission resource type

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported.

Submissions are owned by an assignment. A submission represents the resources that an individual (or group) turn in for an assignment and the grade/feedback that is returned. Submissions are automatically created when an assignment is published. The submission owns two lists of resources. Resources represent the user/groups working area while the submitted resources represent the resources that have actively been turned in by students.

Note: The status is read-only and the object is moved through the workflow via actions.

Methods

Method Return Type Description
Get educationSubmission educationSubmission Read properties and relationships of an educationSubmission object.
List resources educationSubmissionResource collection Get an educationSubmissionResource object collection.
List submittedResources educationSubmissionResource collection Get an educationSubmissionResource object collection.
Update educationSubmission Update an educationSubmission object.
Return educationSubmission A teacher uses return to indicate that the grades/feedback can be shown to the student.
Submit educationSubmission A student uses submit to turn in the assignment. This will copy the resources into the submittedResources folder for grading and updates the status.
Unsubmit educationSubmission A student uses the unsubmit to move the state of the submission from submitted back to working. This will copy the resources into the workingResources folder for grading and updates the status.

Properties

Property Type Description
feedback educationFeedback Holds the feedback property which stores the teacher's notes back to students.
grade educationAssignmentGrade Holds the grade information a teacher assigns to this submission.
id String Read-only.
recipient educationSubmissionRecipient Who this submission is assigned to.
releasedBy identitySet User who moved the status of this submission to released.
releasedDateTime DateTimeOffset Moment in time when the submission was released. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
returnedBy identitySet User who moved the status of this submission to returned.
returnedDateTime DateTimeOffset Moment in time when the submission was returned. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
resourcesFolderUrl String Folder where all file resources for this submission need to be stored.
status string Read-Only. Possible values are: working, submitted, released, returned.
submittedBy identitySet User who moved the resource into the submitted state.
submittedDateTime DateTimeOffset Moment in time when the submission was moved into the submitted state. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
unsubmittedBy identitySet User who moved the resource from submitted into the working state.
unsubmittedDateTime DateTimeOffset Moment in time when the submission was moved from submitted into the working state. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'

Relationships

Relationship Type Description
resources educationSubmissionResource collection Nullable.
submittedResources educationSubmissionResource collection Read-only. Nullable.

JSON representation

The following is a JSON representation of the resource.

{
    "feedback":{"@odata.type":"microsoft.graph.educationFeedback"},
    "grade":{"@odata.type":"microsoft.graph.educationAssignmentGrade"},
    "id":"String (identifier)",
    "recipient":{"@odata.type":"microsoft.graph.educationSubmissionRecipient"},
    "returnedBy":{"@odata.type":"microsoft.graph.identitySet"},
    "returnedDateTime":"String (timestamp)",
    "resourcesFolderUrl":"String",
    "status":"string",
    "submittedBy":{"@odata.type":"microsoft.graph.identitySet"},
    "submittedDateTime":"String (timestamp)",
    "unsubmittedBy":{"@odata.type":"microsoft.graph.identitySet"},
    "unsubmittedDateTime":"String (timestamp)",
    "releasedBy":{"@odata.type":"microsoft.graph.identitySet"},
    "releasedDateTime":"String (timestamp)"
}