Mit Anhängen interagieren

Auf dieser Seite werden die Implementierungsdetails zum Erstellen eines Anhangs und mit Aufgaben von Schülern und Studenten zu arbeiten. Beachten Sie, dass Sie möglicherweise anhangsbezogene Parameter zu verwenden.

Anhang erstellen

Erstellen Sie einen Anhang, indem Sie eine CREATE-Anfrage an den entsprechenden Endpunkt courses.*.addOnAttachments.create. Ihre Anfrage muss Folgendes enthalten: Instanz von AddOnAttachment im Anfragetext.

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: URI für die Lehrkraft, an der die Aufgabe des Schülers/Studenten zu sehen ist den Anhang hinzufügen. 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 Sie die Notenrückgabe unterstützen möchten. Gilt 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 getAddOnContext-Methode ab. mit den Anmeldedaten von Schülern/Studenten.
  3. submissionId und attachmentId werden vom Add-on gespeichert Entwickler als eindeutige Kennung der Aufgabe des Schülers/Studenten an. Für den Fall, dass eine Lehrkraft eine Aufgabe in Classroom kopiert, können Sie die zusammengesetzten Schlüssel dieser beiden Parameter, um einen neuen Anhang im kopierte Aufgabe. Weitere Informationen finden Sie auf unserer Seite zu kopierten Inhalten.
  4. Eine Lehrkraft, die die Arbeiten von Schülern 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. Verwenden Sie den Endpunkt courses.courseWork.addOnAttachments.studentSubmissions, um Informationen über die abgegebene Aufgabe eines Schülers oder Studenten abzurufen oder zu ändern.

Übermittlungsstatus ermitteln

Senden Sie eine GET-Anfrage an die Endpunkt courses.courseWork.addOnAttachments.studentSubmissions, der abgerufen werden soll Details zu einer bestimmten submissionId Sie erhalten eine AddOnAttachmentStudentSubmission-Objekt, das die Note der Einreichung enthält (pointsEarned) und aktueller Status (postSubmissionState). Status der Einreichung kann einer der folgenden Werte sein:

  • 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 zurückgezogen hat für ihre Arbeit.

Verwenden Sie diesen Endpunkt, um den Status der Aufgabe des Schülers/Studenten in Ihrem Add-on zu ermitteln. Ich kann dann die Ansichten oder Optionen, die dem Schüler angeboten werden, je nach zurückgegeben. Dies kann z. B. folgende Funktionen umfassen:

  • Anzeigen des Abgabestatus von Aufgaben in Ihrem Add-on. Dies kann Lernenden dabei zu helfen, Verwirrung zu vermeiden und sicherzustellen, dass sie nicht versehentlich Aufgaben nicht abgegeben werden.
  • Bearbeitungsrechte für Einreichungen werden eingeschränkt. Ob die Zuweisung den Status hat CREATED oder RECLAIMED_BY_STUDENT, der Schüler/Student darf möglicherweise die Datei bearbeiten für ihre Einreichung. Wenn die Zuweisung den Status TURNED_IN oder RETURNED hat, kann 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 Person festzulegen Zuweisung. Wenn eine Lehrkraft mehr als einen Aktivitätstyp-Anhang erstellt, einen maxPoints-Wert bereitstellt, kann nur der erste Anhang den Wert Note der Aufgabe. Lassen Sie den Wert von maxPoints entweder nicht festgelegt oder setzen Sie ihn auf null, die Notenrückgabe für einen Anhang deaktivieren.

Note einer abgegebenen Aufgabe festlegen

Sie können die abgegebenen Aufgaben von Schülern/Studenten ändern, indem Sie eine PATCH-Anfrage an den Endpunkt courses.courseWork.addOnAttachments.studentSubmissions. Die Anfrage Text muss eine Instanz von AddOnAttachmentStudentSubmission mit dem geänderten Werten. 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 über die Classroom-Benutzeroberfläche. Lehrkräfte können den Notenentwurf bearbeiten. bevor Sie die Aufgabe an die Schüler/Studenten zurückgeben. Weitere Informationen finden Sie unter Übersicht über die Benotung in der Classroom-Benutzeroberfläche mit Details zu Noten den Lehrkräften präsentiert werden.

Sie können die Note mit pointsEarned nur in folgenden Fällen festlegen: true:

  • Der Anhang muss einen positiven maxPoints-Wert haben.
  • Das Add-on muss der ursprüngliche Ersteller des Anhangs sein.

Beachten Sie, dass Sie auch maxPoints eines bereits erstellten AddOnAttachment ändern können. durch Senden einer PATCH-Anfrage an den Endpunkt addOnAttachments.

Wann eine Note festgelegt werden sollte

Sie können selbst entscheiden, wann eine Note an Google Classroom zurückgegeben wird. Die Die wichtigste Unterscheidung ist, ob Sie die Lehrkräftedaten so speichern, nur die Lehrkraft kann Noten ändern.

Es gibt zwei Add-on-Momente, bei denen Sie eine Note vergeben können. Google Classroom: wenn der Schüler/Student seine Aufgabe erledigt oder die Lehrkraft öffnet die Aufgabe des Schülers/Studenten im iFrame.

Wenn Sie Noten hinzufügen möchten, nachdem der Schüler/Student die Aufgabe abgeschlossen hat, müssen Sie eine Offline-Anmeldedaten der Lehrkraft abrufen und damit die Note ändern wenn der Schüler oder Student die Aufgabe erledigt hat. Diese Methode bietet einige Vorteile:

  • Stellen Sie nahtlose Notenaktualisierungen bereit. Lehrkräfte müssen keine besonderen , damit Noten auf der Classroom-Benutzeroberfläche eingetragen werden.
  • Mithilfe einer Aufgabe können Sie in Echtzeit den Fortschritt einer Klasse verfolgen. Lehrkräfte können die Noten so festlegen, dass die Schüler und Studenten Anhänge hinzufügen. So bekommen sie ein Gefühl dafür, der Schüler und Studenten ohne jede Einreichung zu öffnen.

Beachten Sie, dass dieser Ansatz auch einen asynchronen Ansatz für das Benoten ermöglicht. synchronisieren. Sie können die AddOnAttachmentStudentSubmission regelmäßig abfragen Endpunkt zu erkennen, wenn ein Schüler/Student seine Aufgabe abgegeben hat. Nach der abgegeben haben, legen Sie mithilfe der gespeicherten Anmeldedaten die Note der abgegebenen Aufgabe fest.

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 in den iFrame der Aufgabe von Schülern/Studenten ein. Dies ist jedoch möglicherweise Besonders reibungslos, da Noten in der Classroom-Benutzeroberfläche nicht in Echtzeit aktualisiert werden und die Lehrkräfte alle den iFrame der Aufgabenbewertung für Schüler/Studenten.

Änderungen an den Noten einer Aufgabe erkennen

können Lehrkräfte die Noteneinstellungen Classroom, nachdem eine Aufgabe erstellt wurde. Solche Änderungen umfassen:

  • Ändern des zugewiesenen Punktwerts.
  • Den maxPoints-Wert einer Zuweisung ändern.
  • Ändern, ob die Aufgabe überhaupt benotet werden soll.

Wenn Sie sich die aktuellen Benotungseinstellungen einer Aufgabe ansehen möchten, sollten Sie Eine GET-Anfrage an den Endpunkt courses.courseWork. Die Antwort enthält Der aktuelle Wert für maxPoints. Eine unbenotete Aufgabe hat den Wert „0“ oder „0“. maxPoints-Wert.

Wenn Sie eine Note an Classroom zurückgegeben haben, verwenden Sie die courses.courseWork.addOnAttachments.studentSubmissions abzurufender Endpunkt oder Note für einen Add-on-Anhang ändern. Der Notenwert wird mithilfe der pointsEarned. Prüfen Sie diesen Wert und aktualisieren Sie ihn bei Bedarf. ob Lehrkräfte in Ihrem Produkt die Punktzahl eines Schülers/Studenten für eine bestimmte Aktivitäten.