Auf dieser Seite erfahren Sie, wie Sie Anhänge erstellen und mit abgegebenen Aufgaben von Schülern/Studenten arbeiten. Beachten Sie, dass Sie für solche Anfragen möglicherweise anhangbezogene Parameter angeben müssen.
Anhang erstellen
Erstellen Sie einen Anhang, indem Sie eine CREATE
-Anfrage an den entsprechenden courses.*.addOnAttachments.create
-Endpunkt senden. Ihre Anfrage muss eine Instanz von AddOnAttachment
im Anfragetext enthalten.
Die folgenden Felder sind beim Erstellen eines Anhangs erforderlich:
title
: der Stringname des Anhangs.teacherViewUri
: der URI für die Ansicht für Lehrkräfte des Anhangs.studentViewUri
: der URI für die Schüler-/Studentenansicht des Anhangs.studentWorkReviewUri
: der URI für die Lehrkraft, die die Arbeit des Schülers/Studenten am Anhang sieht. Dieses Feld ist nur für Anhänge vom Typ „Aktivität“ erforderlich.
Folgende optionale Felder sind sinnvoll:
dueDate
unddueTime
, wenn Sie angeben, wann der Anhang fällig ist.maxPoints
: die höchste Note für den Anhang. Muss ein Wert ungleich null sein, wenn die Notenrücksendung unterstützt werden soll. Gilt nur für Anhänge vom Typ „Aktivität“.
Weitere Informationen zu diesen Feldern finden Sie in der Ressourcenreferenz zu AddOnAttachment
.
Details zu abgegebenen Aufgaben von Schülern/Studenten
Ein typischer Ablauf für Einreichungen sieht folgendermaßen aus:
- Ein Schüler startet
studentViewUri
, um eine Aktivität abzuschließen. - Das Add-on ruft eine
submissionId
aus der MethodegetAddOnContext
mit Studentenanmeldedaten ab. submissionId
undattachmentId
werden vom Add-on-Entwickler als eindeutige Kennzeichnung der Arbeit des Schülers/Studenten gespeichert. Für den Fall, dass eine Lehrkraft eine Aufgabe in Classroom kopiert, können Sie den zusammengesetzten Schlüssel dieser beiden Parameter verwenden, um einen neuen Anhang in der kopierten Aufgabe anzuzeigen. Weitere Informationen finden Sie auf unserer Seite zu kopierten Inhalten.- Eine Lehrkraft, die die Aufgaben von Schülern/Studenten prüfen möchte, startet die
studentWorkReviewUri
. Die Anfrage enthält die folgenden Abfrageparameter:courseId
,itemId
,itemType
,attachmentId
undsubmissionId
. - Der Entwickler des Add-ons verwendet diese vier IDs, um die Aufgaben von Schülern/Studenten abzurufen. Mit dem Endpunkt
courses.courseWork.addOnAttachments.studentSubmissions
können Sie Informationen zu abgegebenen Aufgaben von Schülern oder Studenten abrufen oder ändern.
Übermittlungsstatus ermitteln
Senden Sie eine GET
-Anfrage an den Endpunkt courses.courseWork.addOnAttachments.studentSubmissions
, um Details zu einer bestimmten submissionId
zu erhalten. Sie erhalten ein AddOnAttachmentStudentSubmission
-Objekt, das die Note der abgegebenen Aufgabe (pointsEarned
) und den aktuellen Status (postSubmissionState
) enthält. Der Status der Aufgabe kann einen der folgenden Werte haben:
NEW
, wenn der Schüler/Student nie auf die abgegebene Aufgabe zugegriffen hat.CREATED
, wenn der Schüler/Student eine Aufgabe erstellt, aber noch nicht abgegeben hat.TURNED_IN
, wenn der Schüler/Student seine Aufgabe an die Lehrkraft gesendet hat.RETURNED
, wenn die Lehrkraft die Aufgabe an den Schüler/Studenten zurückgegeben hat.RECLAIMED_BY_STUDENT
, wenn der Schüler/Student seine Aufgabe zurückgezogen hat.
Verwenden Sie diesen Endpunkt, um den Status der Aufgabe des Schülers/Studenten in Ihrem Add-on zu ermitteln. Anschließend können Sie die Ansichten oder Optionen, die dem Schüler oder Studenten zur Verfügung gestellt werden, je nach zurückgegebenem Status anpassen. Dies kann z. B. folgende Funktionen umfassen:
- Anzeigen des Abgabestatus von Aufgaben in Ihrem Add-on. Dies kann den Schülern helfen, potenzielle Verwirrung zu vermeiden und sicherzustellen, dass sie eine Aufgabe nicht versehentlich abgeben.
- Bearbeitungsrechte für Einreichungen werden eingeschränkt. Wenn die Aufgabe den Status
CREATED
oderRECLAIMED_BY_STUDENT
hat, kann der Schüler/Student seine abgegebene Aufgabe möglicherweise bearbeiten. Wenn die Aufgabe den StatusTURNED_IN
oderRETURNED
hat, darf der Schüler/Student seine abgegebene Aufgabe möglicherweise nicht bearbeiten.
Noten und mehrere Anhänge
Es kann nur ein Add-on-Anhang verwendet werden, um die Note für eine einzelne Aufgabe festzulegen. Wenn eine Lehrkraft mehrere Aktivitätsanhänge mit einem maxPoints
-Wert erstellt, kann nur über den ersten solchen Anhang die Note für die Aufgabe festgelegt werden. Lassen Sie den Wert für maxPoints
entweder nicht festgelegt oder setzen Sie ihn auf null, um die Notenrückgabe für einen Anhang zu deaktivieren.
Note einer abgegebenen Aufgabe festlegen
Sie können die abgegebene Aufgabe eines Schülers/Studenten ändern, indem Sie eine PATCH
-Anfrage an den Endpunkt courses.courseWork.addOnAttachments.studentSubmissions
senden. Der Anfragetext muss eine Instanz von AddOnAttachmentStudentSubmission
mit den geänderten Werten enthalten. Legen Sie das Feld pointsEarned
fest, um die Note einer abgegebenen Aufgabe zu ändern.
Der in pointsEarned
übergebene Wert wird zu einem Notenentwurf, der für die Lehrkraft auf der Classroom-Benutzeroberfläche sichtbar ist. Lehrkräfte können den Notenentwurf bearbeiten,
bevor sie die Aufgabe zurückgeben. Ausführliche Informationen zur Darstellung von Noten für Lehrkräfte finden Sie unter Übersicht über die Benotung in der Classroom-Benutzeroberfläche.
Sie können die Note mit pointsEarned
nur festlegen, wenn die folgenden Bedingungen erfüllt sind:
- Der Anhang muss einen positiven
maxPoints
-Wert haben. - Das Add-on muss der ursprüngliche Ersteller des Anhangs sein.
Sie können auch den maxPoints
-Wert eines bereits erstellten AddOnAttachment
ändern, indem Sie eine PATCH
-Anfrage an den Endpunkt addOnAttachments
stellen.
Wann eine Note festgelegt werden sollte
Sie können selbst entscheiden, wann eine Note an Google Classroom zurückgegeben wird. Der wesentliche Unterschied besteht darin, ob Sie die Anmeldedaten der Lehrkraft speichern, da nur diese eine Note ändern kann.
Es gibt zwei Add-on-Momente, in denen Sie eine Note an Google Classroom weitergeben können: wenn der Schüler/Student seine Aufgabe erledigt hat oder wenn die Lehrkraft die Aufgabe des Schülers im iFrame des Schülers/Studenten öffnet.
Wenn Sie Noten festlegen möchten, sobald der Schüler oder Student die Aufgabe erledigt hat, müssen Sie die Offlineanmeldedaten der Lehrkraft speichern und dann die Note abrufen und verwenden, um die Note zu ändern, wenn der Schüler oder Student die Aufgabe fertiggestellt hat. Diese Methode bietet einige potenzielle Vorteile:
- Stellen Sie nahtlose Notenaktualisierungen bereit. Lehrkräfte müssen keine besonderen Maßnahmen ergreifen, damit Noten in der Classroom-Benutzeroberfläche eingetragen werden.
- Mithilfe einer Aufgabe können Sie in Echtzeit den Fortschritt einer Klasse verfolgen. Wenn Lehrkräfte als Noten festlegen, dass die Schüler oder Studenten Anhänge ausfüllen, können sie sich einen Eindruck vom Verständnis der Schüler oder Studenten verschaffen, ohne jede Aufgabe öffnen zu müssen.
Beachten Sie, dass dieser Ansatz auch einen asynchronen Ansatz für die Benotung der Synchronisierung ermöglicht. Sie können den Endpunkt AddOnAttachmentStudentSubmission
regelmäßig abfragen, um festzustellen, ob ein Schüler/Student seine Aufgabe abgegeben hat. Nach dem Einreichen können Sie anhand der gespeicherten Anmeldedaten die Note festlegen.
Wenn Sie die Anmeldedaten der Lehrkraft während einer Schüler-/Studentensitzung nicht laden möchten, können Sie die Anmeldedaten der aktiven Lehrkraft verwenden, wenn diese die abgegebenen Aufgaben des Schülers im iFrame der Aufgabe von Schülern/Studenten lädt. Dies führt jedoch möglicherweise nicht zu einer besonders reibungslosen Nutzererfahrung, da die Noten in der Classroom-Benutzeroberfläche nicht in Echtzeit aktualisiert werden und Lehrkräfte den iFrame für die Aufgabenbewertung von Schülern/Studenten bei jeder Abgabe öffnen müssen.
Änderungen an den Noten einer Aufgabe erkennen
können Lehrkräfte die Noteneinstellungen in Classroom bearbeiten, nachdem eine Aufgabe erstellt wurde. Beispiele für Änderungen:
- Ändern des zugewiesenen Punktwerts.
- Den
maxPoints
-Wert einer Zuweisung ändern. - Ändern, ob die Aufgabe überhaupt benotet werden soll.
Wenn Sie die aktuellen Benotungseinstellungen einer Aufgabe sehen möchten, senden Sie eine GET
-Anfrage an den Endpunkt courses.courseWork
. Die Antwort enthält den aktuellen Wert für maxPoints
. Eine unbenotete Aufgabe hat einen maxPoints
-Wert oder einen Nullwert.
Wenn Sie eine Note an Classroom zurückgegeben haben, verwenden Sie den Endpunkt courses.courseWork.addOnAttachments.studentSubmissions
, um die Note für einen Add-on-Anhang abzurufen oder zu ändern. Der Notenwert wird im Feld pointsEarned
festgelegt. Prüfen Sie diesen Wert und aktualisieren Sie ihn bei Bedarf, wenn Ihr Produkt es den Lehrkräften ermöglicht, die Punktzahl eines Schülers/Studenten für eine bestimmte Aktivität zu bearbeiten.