educationSubmission resource type

Namespace: microsoft.graph

Represents the resources that an individual (or group) turn in for an assignment and the outcomes (such as grades or feedback) that are associated with the submission.

Submissions are owned by an assignment. 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.

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

If setUpResourcesFolder has not been called on an educationSubmission resource, the resourcesFolderUrl property is null.

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.
List outcomes	educationOutcome collection	Get an educationOutcome object collection.
return	educationSubmission	A teacher uses return to indicate that the grades/feedback can be shown to the student.
reassign	educationSubmission	Reassign the submission to the student with feedback for review.
Set up submission specific resources folder	educationSubmission	Create a SharePoint folder (under pre-defined location) to upload files as submission resources.
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
id	String	Unique identifier for the submission.
reassignedBy	identitySet	User who moved the status of this submission to reassigned.
reassignedDateTime	DateTimeOffset	Moment in time when the submission was reassigned. 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 is 2014-01-01T00:00:00Z
recipient	educationSubmissionRecipient	Who this submission is assigned to.
resourcesFolderUrl	String	Folder where all file resources for this submission need to be stored.
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 is 2014-01-01T00:00:00Z
status	string	Read-only. Possible values are: working, submitted, returned, and reassigned. Note that you must use the Prefer: include-unknown-enum-members request header to get the following value(s) in this evolvable enum: reassigned.
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 is 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 is 2014-01-01T00:00:00Z

Relationships

Relationship	Type	Description
outcomes	educationOutcome collection. Holds grades, feedback and/or rubrics information the teacher assigns to this submission	Read-Write. Nullable.
resources	educationSubmissionResource collection	Nullable.
submittedResources	educationSubmissionResource collection	Read-only. Nullable.

JSON representation

The following is a JSON representation of the resource.

{
    "id":"String (identifier)",
    "recipient":{"@odata.type":"microsoft.graph.educationSubmissionRecipient"},
    "returnedBy":{"@odata.type":"microsoft.graph.identitySet"},
    "reassignedBy":{"@odata.type":"microsoft.graph.identitySet"},
    "reassignedDateTime":"String (timestamp)",
    "resourcesFolderUrl":"String",
    "returnedDateTime":"String (timestamp)",
    "status":"string",
    "submittedBy":{"@odata.type":"microsoft.graph.identitySet"},
    "submittedDateTime":"String (timestamp)",
    "unsubmittedBy":{"@odata.type":"microsoft.graph.identitySet"},
    "unsubmittedDateTime":"String (timestamp)"
}