Interakcja z załącznikami

Ta strona zawiera informacje o tworzeniu załączników i pracy z przesyłanymi przez uczniów treściami. Pamiętaj, że podczas wysyłania tych żądań możesz musieć podać parametry dotyczące załączników.

Tworzenie załącznika

Utwórz załącznik, wysyłając żądanie CREATE do odpowiedniego punktu końcowego courses.*.addOnAttachments.create. Treść żądania musi zawierać wystąpienie AddOnAttachment.

Podczas tworzenia załącznika wymagane są te pola:

  • title: nazwa ciągu znaków załącznika.
  • teacherViewUri: identyfikator URI widoku nauczyciela w załączniku.
  • studentViewUri: identyfikator URI widoku ucznia dla załącznika.
  • studentWorkReviewUri: identyfikator URI dla nauczyciela, który pozwala mu wyświetlić pracę ucznia w załączniku. To pole jest wymagane tylko w przypadku załączników typu aktywność.

Możesz podać te pola opcjonalne:

  • dueDate i dueTime, jeśli określasz termin oddania załącznika.
  • maxPoints: maksymalna ocena za załącznik. Jeśli chcesz obsługiwać przekazywanie ocen, musisz podać niezerową wartość. Ma zastosowanie tylko do załączników typu „Aktywność”.

Więcej informacji o tych polach znajdziesz w dokumentacji zasobu AddOnAttachment.

Szczegóły przesłanych przez uczniów zadań

Typowy proces przesyłania składa się z tych kroków:

  1. Uczeń uruchamia aplikację studentViewUri, aby wykonać zadanie.
  2. Dodatek pobiera submissionId z metody getAddOnContext przy użyciu danych logowania uczniów.
  3. Wartości submissionId i attachmentId są przechowywane przez dewelopera dodatku jako unikalny identyfikator pracy ucznia. Jeśli nauczyciel skopiuje projekt w Classroom, możesz użyć klucza złożonego tych dwóch parametrów, aby wyświetlić nowy załącznik w skopiowanym projekcie. Więcej informacji znajdziesz na stronie poświęconej kopiowaniu treści.
  4. Nauczyciel, który chce sprawdzić pracę ucznia, uruchamia studentWorkReviewUri. Żądanie zawiera te parametry zapytania: courseId, itemId, itemType, attachmentId i submissionId.
  5. Deweloper dodatku używa tych 4 identyfikatorów do pobierania zadań uczniów. Użyj punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions, aby pobrać lub zmodyfikować informacje o zadaniach przesłanych przez ucznia.

Wykrywanie stanu przesyłania

Aby uzyskać szczegółowe informacje o konkretnym submissionId, wyślij żądanie GET do punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions. Otrzymujesz obiekt AddOnAttachmentStudentSubmission, który zawiera ocenę zadania (pointsEarned) i obecny stan (postSubmissionState). Stan przesłania może mieć jedną z tych wartości:

  • NEW, jeśli uczeń nigdy nie uzyskał dostępu do przesłanego zadania.
  • CREATED, jeśli uczeń utworzył projekt, ale jeszcze go nie przesłał.
  • TURNED_IN, jeśli uczeń przesłał pracę nauczycielowi.
  • RETURNED, jeśli nauczyciel zwrócił zadanie uczniowi.
  • RECLAIMED_BY_STUDENT, jeśli uczeń „nie przesłał” pracy.

Użyj tego punktu końcowego, aby wykryć stan zadania ucznia w Twoim dodatku. Następnie możesz dostosować widoki lub opcje udostępnione uczniowi w zależności od zwróconego stanu. Mogą to być funkcje takie jak:

  • wyświetlanie stanu oddania zadań w dodatku; Dzięki temu uczniowie unikną potencjalnych nieporozumień i unikną pomyłki podczas oddania projektu.
  • Ograniczenie uprawnień do edycji zgłoszeń. Jeśli projekt ma stan CREATED lub RECLAIMED_BY_STUDENT, uczeń może mieć możliwość edytowania przesłanego projektu. Jeśli zadanie ma stan TURNED_IN lub RETURNED, uczeń może nie mieć możliwości edytowania przesłanego projektu.

Oceny i wiele załączników

Do ustawienia oceny za jedno zadanie można użyć tylko jednego załącznika dodatku. Jeśli nauczyciel utworzy więcej niż jeden załącznik typu „Aktywność”, który zawiera wartość maxPoints, tylko pierwszy z nich może ustawić ocenę projektu. Aby wyłączyć przekazywanie ocen dla załącznika, pozostaw wartość maxPoints nieustawioną lub ustaw ją na 0.

Ustawianie oceny zadania

Przesłane przez ucznia możesz modyfikować, wysyłając żądanie PATCH do punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions. Treść żądania musi zawierać instancję AddOnAttachmentStudentSubmission ze zmienionymi wartościami. Aby zmienić ocenę za zadanie, ustaw pole pointsEarned. Wartość przekazana w pointsEarned stanie się oceną roboczą widoczną dla nauczyciela w interfejsie Classroom. Nauczyciele mogą modyfikować ocenę roboczą przed zwróceniem projektu uczniom. Szczegółowe informacje o sposobie prezentowania ocen nauczycielom znajdziesz w artykule Omówienie oceniania w interfejsie Classroom.

Pamiętaj, że ocenę z wartością pointsEarned możesz ustawić tylko wtedy, gdy spełnione są te warunki:

  • Załącznik musi mieć dodatnią wartość maxPoints.
  • Dodatek musi być pierwotnym twórcą załącznika.

Pamiętaj też, że możesz zmienić już utworzoną wartość maxPoints elementu AddOnAttachment, wysyłając żądanie PATCH do punktu końcowego addOnAttachments.

Kiedy wyznaczać ocenę

Masz możliwość wyboru, kiedy ocena ma zostać zwrócona do Google Classroom. Istotną różnicą jest to, czy zdecydujesz się przechowywać dane logowania nauczyciela, ponieważ tylko on może modyfikować ocenę.

Istnieją 2 momenty, w których możesz przekazać ocenę do Google Classroom: gdy uczeń ukończy pracę lub gdy nauczyciel otworzy zadanie ucznia w ramce iframe.

Jeśli chcesz wystawiać oceny po wykonaniu zadania przez ucznia, musisz zapisać dane logowania offline nauczyciela, a następnie pobrać je i używać ich do modyfikowania oceny po ukończeniu zadania przez ucznia. Ta metoda może przynieść pewne korzyści:

  • zapewniać płynne aktualizacje ocen; Nauczyciele nie muszą podejmować żadnych specjalnych działań, aby oceny były wypełniane w interfejsie Classroom.
  • Udostępnianie w czasie rzeczywistym informacji o postępach klasy w realizacji projektu. Ustawiając oceny po wypełnieniu przez uczniów załączników, nauczyciele mogą sprawdzić, czy ich uczniowie rozumieją materiał, bez otwierania każdej przesłanej pracy.

Pamiętaj, że to podejście umożliwia też asynchroniczne podejście do synchronizacji ocen. Możesz okresowo sprawdzać punkt końcowy AddOnAttachmentStudentSubmission, aby wykryć, kiedy uczeń przesłał swoje zadanie. Po przesłaniu zadania ustaw jego ocenę, używając zapisanych danych logowania.

Jeśli nie chcesz wczytywać danych logowania nauczyciela podczas sesji ucznia, możesz użyć danych logowania aktywnego nauczyciela, gdy wczytuje on zadanie ucznia w elemencie iframe sprawdzania pracy ucznia. Jednak może to nie zapewnić płynnej obsługi, ponieważ oceny w interfejsie Classroom nie są aktualizowane w czasie rzeczywistym, a nauczyciele będą musieli otworzyć element iframe z oceną prac uczniów w każdym zgłoszeniu.

Wykrywanie zmian w ocenach projektów

nauczyciele mogą edytować ustawienia ocen w Classroom po utworzeniu projektu. Takie zmiany mogą obejmować:

  • Zmiana przypisanej liczby punktów.
  • Zmiana wartości maxPoints projektu.
  • określanie, czy w ogóle ma być oceniany projekt.

Aby wyświetlić bieżące ustawienia oceniania projektu, zalecamy wysłanie żądania GET do punktu końcowego courses.courseWork. Odpowiedź zawiera bieżącą wartość maxPoints. Nieoceniona praca domowa ma wartość null lub zero w polu maxPoints.

Jeśli ocena została przekazana z powrotem do Classroom, użyj punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions, aby pobrać lub zmienić ocenę załączonego dodatku. Wartość oceny jest ustawiana w polu pointsEarned. Jeśli Twoja usługa umożliwia nauczycielom edytowanie wyników uczniów w przypadku konkretnej aktywności, warto sprawdzić tę wartość i w razie potrzeby zaktualizować ją.