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 wyborów nauczyciela wyślij co najmniej 1 żądanie dotyczące dodatku create, aby dodać załączniki do projektu.

Inne iframe

Element iframe widoku ucznia, element iframe sprawdzania prac uczniów i element iframe widoku nauczyciela mają na celu prezentowanie treści użytkownikowi, a nie modyfikowanie projektu w Classroom. W przypadku tych widoków możesz wykonać te czynności:

  • Gdy otworzy się iframe, uzyskaj zgodę użytkownika na OAuth, a następnie zweryfikuj jego rolę i identyfikator załącznika.
  • Gdy otworzy się iframe, na podstawie wartości itemType zweryfikuj rolę użytkownika, tworząc courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest lub announcements.GetAddOnContextRequest.
  • 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ć zgodny we wszystkich widokach.
  • Jeśli attachmentId jest już znane dodatkowi, wyświetl odpowiednie interfejs załącznika.
  • W przeciwnym razie wiadomość zawierająca ten załącznik została skopiowana z innej wiadomości lub kursu. Użyj elementu 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.