Na tej stronie znajdziesz krótkie omówienie najważniejszych interakcji między aplikacją internetową dodatku a interfejsem API dodatków do Google Classroom.
Element iframe wykrywania załączników
Element iframe wykrywania załączników to strona docelowa dla nauczycieli korzystających z dodatku. Rozważ podjęcie następujących działań dotyczących tego widoku:
- Po otwarciu elementu iframe wykrywania załączników utwórz
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
lubannouncements.GetAddOnContextRequest
na podstawieitemType
, aby zweryfikować rolę użytkownika i uzyskać wartośćsupportsStudentWork
. - Pokaż interfejs do odkrywania lub tworzenia treści. Możesz pominąć załączniki typu aktywności na podstawie wartości
supportsStudentWork
w odpowiedzi na weryfikację uruchomienia. - Na podstawie wyboru nauczyciela wyślij co najmniej 1 dodatkową prośbę (
create
), aby dodać załączniki do projektu.
Inne elementy iframe
Elementy iframe Widok ucznia, Element iframe do sprawdzania zadań uczniów i Element iframe w widoku nauczyciela służą do prezentowania treści użytkownikowi, a nie do modyfikowania projektu Classroom. Rozważ podjęcie następujących działań w odniesieniu do takich poglądów:
Po otwarciu elementu iframe uzyskaj zgodę użytkownika za pomocą protokołu OAuth, a następnie zweryfikuj jego rolę i identyfikator załącznika.
- 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 – dopasowaniesubmissionIds
jest zgodne w różnych widokach. - Jeśli element
attachmentId
jest już znany w postaci dodatku, pokaż odpowiedni interfejs załącznika. - W przeciwnym razie musi być tak, że nadrzędny post danego załącznika został skopiowany z innego posta lub zajęć. Użyj metody
copyHistory
, aby znaleźć najnowszą kopię znaną dla dodatku, i skopiuj z niej ustawienia, aby po stronie dodatku utworzyć nowy model załącznika. Następnie pokaż interfejs użytkownika odpowiedniego załącznika.
- Jeśli bieżący użytkownik jest uczniem, powiąż element