Strategia wdrożenia

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 lub announcements.GetAddOnContextRequest na podstawie itemType, 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 – dopasowanie submissionIds 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.