Ta strona zawiera krótkie omówienie najważniejszych interakcji między aplikacją internetową dodatku a interfejsem API dodatków Google Classroom.
Element iframe wykrywania załączników
Element iframe wykrywania załączników to strona docelowa dla nauczycieli w dodatku. Rozważ wykonanie tych czynności dotyczących tego widoku:
Pokazuj interfejs odkrywania lub tworzenia treści.
Opcjonalnie możesz określić, czy element strumienia będzie akceptować odpowiedzi uczniów, ponieważ możesz uniemożliwić nauczycielowi dodawanie załączników typu aktywności. Sprawdź wartość parametru zapytania
itemType
, który był przekazywany po otwarciu dodatku iframed. Tylko typcourseWork
akceptuje odpowiedzi uczniów.W zależności od wyboru nauczycieli wyślij prośbę o dodanie do projektu co najmniej 1 prośby o dodatek
create
.
Inne elementy iframe
Elementy element iframe widoku ucznia, element iframe do sprawdzania zadań uczniów i element iframe widoku nauczyciela służą do prezentowania treści użytkownikowi, a nie do modyfikowania projektu Classroom. Rozważ wykonanie tych czynności w odniesieniu do tych widoków:
- Po otwarciu elementu iframe uzyskaj zgodę użytkownika związaną z protokołem OAuth, a następnie zweryfikuj jego rolę i identyfikator załącznika.
- Po otwarciu elementu iframe utwórz element
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
lubannouncements.GetAddOnContextRequest
w zależności od tego, jaki element maitemType
, aby potwierdzić rolę użytkownika. - Jeśli bieżący użytkownik jest uczniem, powiąż element
submissionId
z odpowiedzi z zadaniem ucznia. Jest to wymagane do przekazywania ocen i wyświetlania zadań uczniów nauczycielom w narzędziu do oceniania;submissionIds
są zgodne w różnych widokach. - Jeśli dodatek
attachmentId
jest już znany dla dodatku, pokaż odpowiedni interfejs załącznika. - W przeciwnym razie może się zdarzyć, że post nadrzędny danego załącznika został skopiowany z innego posta lub kursu. Użyj narzędzia
copyHistory
, aby znaleźć ostatnią kopię znaną mu przez dodatek, a następnie skopiuj z niego ustawienia, aby utworzyć po stronie dodatku nowy model załącznika. Następnie pokaż odpowiedni interfejs użytkownika do obsługi załączników.