Auf dieser Seite erhalten Sie einen kurzen Überblick über die wichtigsten Interaktionen zwischen Ihrer Add-on-Webanwendung und der 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 das Streamelement die Antworten der Schüler/Studenten akzeptiert. So können Sie verhindern, dass die Lehrkraft Anhänge vom Typ „Aktivität“ hinzufügt. Prüfen Sie den Wert des Abfrageparameters
itemType
, der beim Öffnen des Add-on-iFrames übergeben wurde. Nur für den TypcourseWork
werden Antworten von Schülern/Studenten akzeptiert.Je nach Auswahl der Lehrkraft können Sie eine oder mehrere
create
-Add-on-Anfragen stellen, um der Aufgabe Anhänge hinzuzufügen.
Andere iFrames
Die iFrames für die Schüler-/Studentenansicht, der iFrame der Aufgabenbewertung von Schülern/Studenten und der iFrame für die Lehrkräfteansicht sind dazu gedacht, dem Nutzer Inhalte zu präsentieren, anstatt eine Classroom-Aufgabe zu ändern. Erwägen Sie in Bezug auf diese Ansichten die folgenden Maßnahmen zu ergreifen:
- Holen Sie beim Öffnen eines iFrames die OAuth-Zustimmung des Nutzers ein und validieren Sie dann seine Rolle und die Anhangs-ID.
- Wenn ein iFrame geöffnet wird, erstellen Sie ein
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
oderannouncements.GetAddOnContextRequest
basierend auf demitemType
, um die Nutzerrolle zu validieren. - Wenn der aktuelle Nutzer ein Schüler/Student ist, verknüpfen Sie die
submissionId
aus der Antwort mit der Aufgabe des Schülers/Studenten. Dies ist erforderlich, um Noten bekannt zu geben und den Lehrkräften Aufgaben von Schülern/Studenten im Benotungstool anzuzeigen; die ÜbereinstimmungsubmissionIds
für alle Ansichten. - Wenn das
attachmentId
dem Add-on bereits bekannt ist, rufen Sie die entsprechende UI für Anhänge auf. - Andernfalls muss der übergeordnete Beitrag dieses Anhangs aus einem anderen Beitrag oder Kurs kopiert worden sein. Ermitteln Sie mit
copyHistory
die aktuellste Kopie, die dem Add-on bekannt ist, und kopieren Sie die Einstellungen daraus, um auf der Add-on-Seite ein neues entsprechendes Modell des Anhangs zu erstellen. Zeigen Sie dann die entsprechende UI für Anhänge an.