Strategia wdrożenia

Ta strona zawiera krótki opis najważniejszych interakcji między aplikacją internetową dodatku a interfejsem API dodatków Google Classroom.

Element iframe usługi Attachment Discovery

Iframe Odkrywaj załączniki to strona docelowa dla nauczycieli w Twoim dodatku. W związku z tą opinią możesz wykonać te czynności:

  • Pokaż interfejs wyszukiwania lub tworzenia treści.

    Opcjonalnie określ, czy element strumienia będzie akceptował odpowiedzi uczniów, ponieważ możesz chcieć uniemożliwić nauczycielowi dodawanie załączników typu aktywność. Sprawdź wartość parametru zapytania itemType, który został przekazany podczas otwierania iframe dodatku. Odpowiedzi studentów są akceptowane tylko w przypadku typu courseWork.

  • W zależności od wyboru nauczycieli wyślij prośbę o dodanie do projektu co najmniej 1 prośby o dodatek create.

Inne iframe

Element iframe widoku ucznia, element iframe sprawdzania pracy ucznia i element iframe widoku nauczyciela mają na celu prezentowanie treści użytkownikowi, a nie modyfikowanie projektu w Classroom. Rozważ wykonanie tych czynności w odniesieniu do tych widoków:

  • Gdy otworzy się iframe, uzyskaj zgodę użytkownika na OAuth, a następnie zweryfikuj jego rolę i identyfikator załącznika.
  • Gdy otworzy się iframe, utwórz courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest lub announcements.GetAddOnContextRequest na podstawie itemType, aby zweryfikować rolę użytkownika.
  • Jeśli bieżący użytkownik jest uczniem, powiązaj submissionId z odpowiedzią z zadaniem ucznia. Jest to wymagane do przekazywania ocen oraz wyświetlania prac uczniów nauczycielom w narzędziu do oceniania.submissionIds musi być taki sam we wszystkich widokach.
  • Jeśli attachmentId jest już znany dodatkowi, wyświetl odpowiedni interfejs załącznika.
  • W przeciwnym razie wiadomość zawierająca ten załącznik została skopiowana z innej wiadomości lub kursu. Użyj copyHistory, aby znaleźć najnowszą kopię, o której wie dodatek, i skopiuj z niej ustawienia, aby utworzyć nowy odpowiedni model załącznika po stronie dodatku. Następnie wyświetl odpowiedni interfejs załącznika.