Strategia wdrożenia

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 typ courseWork 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 lub announcements.GetAddOnContextRequest w zależności od tego, jaki element ma itemType, 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.