Mit Anhängen interagieren

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 und dueTime, 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:

  1. Ein Schüler startet studentViewUri, um eine Aktivität abzuschließen.
  2. Das Add-on ruft eine submissionId aus der Methode getAddOnContext mit Studentenanmeldedaten ab.
  3. submissionId und attachmentId 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.
  4. 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 und submissionId.
  5. 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 oder RECLAIMED_BY_STUDENT hat, kann der Schüler/Student seine abgegebene Aufgabe möglicherweise bearbeiten. Wenn die Aufgabe den Status TURNED_IN oder RETURNED 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.