Diese Seite bietet einen kurzen Überblick über die wichtigsten Interaktionen zwischen Ihrem Add-on-Web und die Google Classroom Add-ons API.
iFrame für die Anhangserkennung
Der iFrame zur Anhangserkennung ist die Landingpage für Lehrkräfte in Ihrem Add-on. Ergreifen Sie gegebenenfalls folgende Maßnahmen für diese Ansicht:
Blenden Sie die Benutzeroberfläche für die Inhaltssuche oder -erstellung ein.
Legen Sie optional fest, ob die Antworten der Schüler/Studenten auf das Streamelement akzeptiert werden. da Sie vielleicht verhindern möchten, dass die Lehrkraft den Aktivitätstyp Anhänge. Prüfen Sie den Wert des
itemType
-Abfrageparameters, der im die beim Öffnen des Add-on-iFrames übergeben wurde. Nur der TypcourseWork
akzeptiert die Antworten der Schüler/Studenten.Basierend auf der Auswahl der Lehrkraft eine oder mehrere
create
-Anfragen für Add-ons stellen bei Anhänge zur Aufgabe hinzufügen.
Andere iFrames
iFrames „Schüleransicht“, „Aufgaben von Schülern/Studenten ansehen“-iFrame und „Lehreransicht“ iFrame sind alle dazu gedacht, dem Nutzer Inhalte zu präsentieren, anstatt ein Element zu verändern. Aufgabe in Classroom. Erwägen Sie Folgendes: zu diesen Ansichten:
- Holen Sie beim Öffnen eines iFrames die OAuth-Einwilligung des Nutzers ein und validieren Sie dann seine Rolle und die Anhangs-ID.
- Wenn ein iFrame geöffnet wird, erstellen Sie einen
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
oderannouncements.GetAddOnContextRequest
basierend auf demitemType
-Objekt zur Validierung Nutzerrolle - Wenn der aktuelle Nutzer ein Schüler oder Student ist, verknüpfe
submissionId
aus der mit der Arbeit der Schüler oder Studenten. Dies ist erforderlich, um Noten und um Lehrkräften Aufgaben von Schülern/Studenten im Benotungstool zu zeigen diesubmissionIds
Übereinstimmung bei allen Ansichten. - Wenn das
attachmentId
dem Add-on bereits bekannt ist, blenden Sie das entsprechende Element ein. UI für Anhänge. - Andernfalls muss der übergeordnete Beitrag dieses Anhangs
aus einem anderen Beitrag oder Kurs kopiert. Mit
copyHistory
ermitteln Sie, welche die dem Add-on bekannt sind, und kopieren Sie die Einstellungen daraus in Erstellen Sie auf der Add-on-Seite ein neues entsprechendes Modell des Anhangs. Gehen Sie dann so vor: entsprechende UI für Anhänge anzeigen.