Auf dieser Seite werden die Implementierungsdetails zum Erstellen eines Anhangs und Aufgaben von Schülern und Studenten bearbeiten. 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
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 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:
- Ein Schüler startet
studentViewUri
, um eine Aktivität abzuschließen. - Das Add-on ruft eine
submissionId
aus dergetAddOnContext
-Methode ab. mit den Anmeldedaten von Schülern/Studenten. submissionId
undattachmentId
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.- 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
undsubmissionId
. - 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
courses.courseWork.addOnAttachments.studentSubmissions
-Endpunkt
Details zu einer bestimmten submissionId
Sie erhalten eine
AddOnAttachmentStudentSubmission
-Objekt, das die Note der abgegebenen Aufgabe 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
oderRECLAIMED_BY_STUDENT
, der Schüler/Student darf möglicherweise die Datei bearbeiten für ihre Einreichung. Wenn die Zuweisung den StatusTURNED_IN
oderRETURNED
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 entscheidende 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 Schüler und Studenten Anhänge hinzufügen. 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.