educationAssignment-RessourcentypeducationAssignment resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Die educationAssignment -Ressource stellt eine Aufgabe oder Arbeitseinheit dar, die einem Schüler oder Teammitglied in einer Klasse als Teil ihrer Studie zugewiesen ist.The educationAssignment resource represents a task or unit of work assigned to a student or team member in a class as part of their study. Nur Lehrer oder Teambesitzer können Zuordnungen erstellen.Only teachers or team owners can create assignments. Zuordnungen enthalten Handzettel und Aufgaben, an denen der Kursleiter arbeiten möchte.Assignments contain handouts and tasks that the teacher wants the student to work on. Jede Schüler Zuordnung verfügt über eine zugeordnete Übermittlung , die alle Aufgaben enthält, die Ihr Lehrer für die Einwahl angefordert hat.Each student assignment has an associated submission that contains any work their teacher asked to be turned in. Ein Lehrer kann dem von dem Schüler eingereichten Beitrag Partituren und Feedback hinzufügen.A teacher can add scores and feedback to the submission turned in by the student.

Wenn eine Zuordnung erstellt wird, befindet Sie sich im Entwurfsstatus.When an assignment is created, it is in a Draft state. Die Teilnehmer können die Zuordnung nicht sehen, und Übermittlungen werden nicht erstellt.Students can't see the assignment and submissions won't be created. Sie können den Status einer Zuordnung mithilfe der Veröffentlichungsaktion ändern.You can change the status of an assignment by using the publish action. Sie können keine Patch-Anforderung verwenden, um den Zuordnungsstatus zu ändern.You can't use a PATCH request to change the assignment status.

Die Zuordnungs-APIs werden im Klassennamespace verfügbar gemacht.The assignment APIs are exposed in the class namespace.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Ressourcen auflistenList resources educationAssignmentResource -SammlungeducationAssignmentResource collection Rufen Sie eine educationAssignmentResource -Objektsammlung ab.Get an educationAssignmentResource object collection.
Einsendungen auflistenList submissions educationSubmission -SammlungeducationSubmission collection Rufen Sie eine educationSubmission -Objektsammlung ab.Get an educationSubmission object collection.
Kategorien auflistenList categories educationCategory -SammlungeducationCategory collection Rufen Sie eine educationCategory -Objektsammlung ab.Get an educationCategory object collection.
Zugeordnete Ressource erstellenCreate assignment resource educationAssignmentResourceeducationAssignmentResource Erstellen Sie eine neue educationAssignmentResource durch veröffentlichen in der Resources-Auflistung.Create a new educationAssignmentResource by posting to the resources collection.
Zuweisung abrufenGet assignment educationAssignmenteducationAssignment Lesen von Eigenschaften und Beziehungen eines educationAssignment -Objekts.Read properties and relationships of an educationAssignment object.
UpdateUpdate educationAssignmenteducationAssignment Aktualisieren eines educationAssignment -Objekts.Update an educationAssignment object.
DeleteDelete KeineNone Löschen eines educationAssignment -Objekts.Delete an educationAssignment object.
Kategorien hinzufügenAdd categories educationCategoryeducationCategory Weisen Sie dieser Zuordnung ein educationCategory zu, das der Klasse gehört.Assign an educationCategory belonging to the class to this assignment.
Kategorie entfernenRemove category KeineNone Entfernen Sie aus dieser Zuweisung ein educationCategory , das zur Klasse gehört.Remove an educationCategory belonging to the class from this assignment.
Rubrik anfügenAttach rubric KeineNone Anfügen eines vorhandenen educationRubric an diese Zuordnung.Attach an existing educationRubric to this assignment.
Rubrik entfernenRemove rubric KeineNone Trennen Sie die educationRubric von dieser Zuordnung.Detach the educationRubric from this assignment.
PublishPublish educationAssignmenteducationAssignment Ändern Sie den Zustand eines educationAssignment -Objekts von Entwurf in veröffentlicht.Change the state of an educationAssignment object from draft to published.
URL für Ressourcenordner abrufenGet resource folder URL stringstring Der OneDrive-Ordner, in dem dateibasierte Ressourcen als Teil einer Zuordnungs Ressource positioniert werden sollen.The OneDrive folder into which file-based resources should be placed to be part of an assignment resource. Dateien müssen sich in diesem Ordner befinden, damit Sie als Ressource hinzugefügt werden können.Files must be located in this folder to be added as a resource.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
idid StringString Schreibgeschützt.Read-only.
allowLateSubmissionsallowLateSubmissions BooleschBoolean Gibt an, ob Kursteilnehmer nach dem Fälligkeitsdatum übermitteln können.Identifies whether students can submit after the due date. Wenn diese Eigenschaft während Create nicht angegeben wird, wird Sie standardmäßig auf true festgelegt.If this property is not specified during create, it defaults to true.
allowStudentsToAddResourcesToSubmissionallowStudentsToAddResourcesToSubmission BooleschBoolean Gibt an, ob Kursteilnehmer eigene Ressourcen zu einer Übermittlung hinzufügen oder nur Ressourcen ändern können, die vom Lehrer hinzugefügt wurden.Identifies whether students can add their own resources to a submission or if they can only modify resources added by the teacher.
assignDateTimeassignDateTime DateTimeOffsetDateTimeOffset Das Datum, an dem die Zuordnung aktiv werden soll.The date when the assignment should become active. Wenn die Zuordnung zukünftig dem Kursteilnehmer bis zu diesem Datum nicht angezeigt wird.If in the future, the assignment is not shown to the student until this date. Der timestamp -Typ stellt Datums-und Uhrzeitinformationen im Format ISO 8601 dar und ist immer in UTC-Zeit.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
assignToassignTo educationAssignmentRecipienteducationAssignmentRecipient Welche Benutzer oder ganze Klasse ein Übermittlungs Objekt erhalten soll, nachdem die Zuweisung veröffentlicht wurde.Which users, or whole class should receive a submission object once the assignment is published.
assignedDateTimeassignedDateTime DateTimeOffsetDateTimeOffset Der Moment, an dem die Zuordnung für Schüler veröffentlicht wurde, und die Zuordnung wird auf der Zeitachse der Teilnehmer angezeigt.The moment that the assignment was published to students and the assignment shows up on the students timeline. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
classIdclassId StringString Klasse, zu der diese Zuordnung gehört.Class which this assignment belongs.
createdBycreatedBy identitySetidentitySet Die Person, die die Zuordnung erstellt hat.Who created the assignment.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Zeitpunkt, zu dem die Zuordnung erstellt wurde.Moment when the assignment was created. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
displayNamedisplayName ZeichenfolgeString Der Name der Zuordnung.Name of the assignment.
dueDateTimedueDateTime DateTimeOffsetDateTimeOffset Datum, an dem die Zuordnung der Teilnehmer fällig ist.Date when the students assignment is due. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
Benotungsgrading educationAssignmentGradeTypeeducationAssignmentGradeType Wie die Zuordnung benotet wird.How the assignment will be graded.
Anweisungeninstructions itemBodyitemBody Anweisungen für die Zuordnung.Instructions for the assignment. Dies zusammen mit dem Anzeigenamen teilen Sie dem Schüler mit, was zu tun ist.This along with the display name tell the student what to do.
lastModifiedBylastModifiedBy identitySetidentitySet Wer die Zuordnung zuletzt geändert hat.Who last modified the assignment.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Zeitpunkt, zu dem die Zuordnung zuletzt geändert wurde.Moment when the assignment was last modified. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
statusstatus stringstring Status der Zuordnung.Status of the Assignment. Sie können diesen Wert nicht patchen.You can not PATCH this value. Mögliche Werte sind: draft, published und assigned.Possible values are: draft, published, assigned.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
Ressourcenresources educationAssignmentResource -SammlungeducationAssignmentResource collection Lernobjekte, die dieser Zuordnung zugeordnet sind.Learning objects that are associated with this assignment. Nur Lehrer können diese Liste ändern.Only teachers can modify this list. Nullwerte zulassend.Nullable.
Einreichungensubmissions educationSubmission -SammlungeducationSubmission collection Nach der Veröffentlichung gibt es ein Submissions-Objekt für jeden Schüler, der seine Arbeit und seine Note darstellt.Once published, there is a submission object for each student representing their work and grade. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.
categoriescategories educationCategory -SammlungeducationCategory collection Wenn festgelegt, können Benutzer problemlos Zuordnungen eines bestimmten Typs finden.When set, enables users to easily find assignments of a given type. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.
Rubrikrubric educationRubriceducationRubric Wenn dieser Wert festgelegt ist, wird dieser Zuordnung die Bewertungs Rubrik zugeordnet.When set, the grading rubric attached to this assignment.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.

{
  "id": "String (identifier)",
  "allowLateSubmissions": true,
  "allowStudentsToAddResourcesToSubmission": true,
  "assignDateTime": "String (timestamp)",
  "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
  "assignedDateTime": "String (timestamp)",
  "classId": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "dueDateTime": "String (timestamp)",
  "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
  "instructions": {"@odata.type": "microsoft.graph.itemBody"},
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "status": "string"
}