Interakcja z załącznikami

Na tej stronie znajdują się szczegółowe informacje o implementacji tworzenia załączników oraz pracy z materiałami przesłanymi przez uczniów. Pamiętaj, że może być konieczne przesłanie atrybutu parametrów związanych z załącznikami podczas wysyłania tych żądań.

Tworzenie załącznika

Utwórz załącznik, wysyłając żądanie CREATE do odpowiedniego Punkt końcowy courses.*.addOnAttachments.create. Prośba musi zawierać wystąpienia AddOnAttachment w treści żądania.

Podczas tworzenia załącznika wymagane są następujące pola:

  • title: nazwa ciągu znaków załącznika.
  • teacherViewUri: identyfikator URI widoku nauczyciela w załączniku.
  • studentViewUri: identyfikator URI widoku ucznia załącznika.
  • studentWorkReviewUri: identyfikator URI, pod którym nauczyciel może zobaczyć pracę ucznia. załącznik. To pole jest wymagane tylko w przypadku załączników typu aktywności.

Możesz dodać niektóre z tych pól opcjonalnych:

  • dueDate i dueTime, jeśli określasz termin oddania załącznika.
  • maxPoints: maksymalna ocena za załącznik. Wartość musi być różna od 0 jeśli chcesz obsługiwać funkcję przebiegu zwrotnego ocen. Zostanie zastosowane do załączników typu aktywność

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

Szczegóły zadania przesłanego przez ucznia

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. submissionId i attachmentId są przechowywane przez dodatek. jako unikalnego identyfikatora pracy ucznia. W przypadku, gdy nauczyciel skopiuje projekt w Classroom, możesz użyć złożony z tych dwóch parametrów, aby wyświetlić nowy załącznik w skopiowano projekt. Więcej informacji znajdziesz na naszej stronie o kopiowanych treściach.
  4. Nauczyciel zainteresowany sprawdzaniem prac uczniów uruchamia studentWorkReviewUri Żądanie zawiera następujące parametry zapytania: courseId, itemId, itemType, attachmentId i submissionId.
  5. Deweloper dodatku używa tych 4 identyfikatorów do pobierania zadań uczniów. Używaj punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions, pobierania lub modyfikowania informacji o zadaniach przesłanych przez ucznia.

Wykryj stan przesłania

Wyślij prośbę GET do courses.courseWork.addOnAttachments.studentSubmissions – punkt końcowy, aby uzyskać szczegóły na temat: submissionId. Otrzymujesz AddOnAttachmentStudentSubmission obiekt, który zawiera ocenę zadania (pointsEarned) i bieżący stan (postSubmissionState). Stan zgłoszenia może mieć jedną z tych wartości:

  • NEW, jeśli uczeń nigdy nie otwierał projektu.
  • CREATED, jeśli uczeń utworzył zadanie, ale jeszcze go nie przesłał.
  • TURNED_IN, jeśli uczeń przesłał swoje zadanie nauczycielowi.
  • RETURNED, jeśli nauczyciel zwrócił zadanie uczniowi.
  • RECLAIMED_BY_STUDENT, jeśli uczeń „cofnął przesłanie” swoją pracę.

Za pomocą tego punktu końcowego możesz wykryć stan pracy ucznia w dodatku. Ty może następnie dostosować widoki lub opcje udostępniane uczniowi w zależności stan. Może to obejmować na przykład:

  • Wyświetlanie stanu oddania projektów w dodatku. Może to spowodować pomóc uczniom uniknąć potencjalnych pomyłek i uniknąć pomyłek oddania projektu.
  • Ograniczenie uprawnień do edycji przesyłanych treści. Jeśli projekt ma stan CREATED lub RECLAIMED_BY_STUDENT, uczeń może mieć możliwość edytowania ich zgłoszenia. Jeśli projekt ma stan TURNED_IN lub RETURNED, uczeń może nie mieć uprawnień do edytowania swojego projektu.

Oceny i wiele załączników

Do przyznania oceny pojedynczego załącznika dodatku można użyć tylko jednego projektu. Jeśli nauczyciel utworzy więcej niż jeden załącznik typu ćwiczenia, zawiera wartość maxPoints, tylko pierwsze takie przyłącze może ustawić ocenę projektu. Pozostaw wartość maxPoints nieskonfigurowana lub ustaw ją na 0 wyłączyć synchronizację ocen za załącznik.

Ustawianie oceny zadania

Możesz zmodyfikować zadanie przesłane przez ucznia, wysyłając prośbę PATCH do Punkt końcowy courses.courseWork.addOnAttachments.studentSubmissions. Żądanie ciało musi zawierać instancję AddOnAttachmentStudentSubmission z parametrem zmodyfikowanych wartości. Aby zmienić ocenę za zadanie, ustaw pole pointsEarned. Wartość przekazana w funkcji pointsEarned staje się wersją roboczą widoczną dla w interfejsie Classroom. Nauczyciele mogą modyfikować wersję roboczą oceny przed zwróceniem projektu uczniom. Zapoznaj się z Omówieniem oceniania w Interfejs Classroom ze szczegółowymi informacjami o ocenach. przedstawiane nauczycielom.

Pamiętaj, że ocenę możesz ustawić za pomocą funkcji pointsEarned tylko wtedy, gdy są spełnione true (prawda):

  • Załącznik musi mieć wartość dodatnią maxPoints.
  • Dodatek musi być autorem załącznika.

Pamiętaj też, że możesz modyfikować już utworzone właściwości maxPoints elementu AddOnAttachment przez wysłanie żądania PATCH do punktu końcowego addOnAttachments.

Kiedy wyznaczać ocenę

Masz możliwość wyboru, kiedy ocena ma zostać zwrócona do Google Classroom. jest to, czy zdecydujesz się przechowywać dane logowania nauczyciela, tylko nauczyciel może zmienić ocenę.

Są dwa dodatkowe momenty, w których można zdać ocenę Google Classroom: gdy uczeń ukończy zadanie lub nauczyciel otwiera zadanie ucznia w elemencie iframe z oceną pracy ucznia.

Jeśli chcesz ustawić oceny po wykonaniu przez ucznia zadania, musisz zapisać plik danych logowania offline nauczyciela, a następnie pobrać je i użyć ich do zmodyfikowania oceny gdy uczeń ukończy zadanie. Metoda ta daje pewien potencjał Korzyści:

  • Sprawne aktualizowanie ocen. Nauczyciele nie muszą poświęcać czasu powoduje wypełnianie ocen w interfejsie Classroom.
  • Zapewnianie w czasie rzeczywistym informacji o postępach zajęć w projekcie. Dzięki temu, gdy uczniowie wypełniają załączniki, nauczyciele mogą dowiedzieć się więcej swoich uczniów bez otwierania kolejnych zgłoszeń.

Takie podejście pozwala też zastosować asynchroniczne podejście do oceniania. synchronizację. Możesz okresowo przeprowadzać ankiety dotyczące AddOnAttachmentStudentSubmission który pozwala wykryć, kiedy uczeń przesłał swoje zadanie. Gdy jest przesłane, ustaw ocenę zadania, 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 podczas wczytywania danych logowania ucznia przesłane w elemencie iframe Sprawdzanie pracy ucznia. Może to jednak nie zapewnić szczególnie bezproblemowe są oceny w interfejsie Classroom. nie aktualizują się w czasie rzeczywistym, a nauczyciele będą musieli elementu iframe oceny pracy ucznia.

Wykrywanie zmian w ocenach projektów

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

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

Aby zobaczyć bieżące ustawienia oceniania projektu, zalecamy wysłanie żądanie GET do punktu końcowego courses.courseWork. Odpowiedź zawiera bieżącą wartość maxPoints. Projekt bez oceny ma wartość null lub zero Wartość: maxPoints.

Jeśli udało Ci się zdać ocenę w Classroom, użyj courses.courseWork.addOnAttachments.studentSubmissions punkt końcowy do pobrania lub zmienić ocenę załącznika dodatku. Wartość oceny jest ustawiana za pomocą pointsEarned. Rozważ sprawdzenie i w razie potrzeby zaktualizowanie tej wartości jeśli Twoja usługa umożliwia nauczycielom edytowanie wyniku ucznia dla określonej działania.