Interakcja z załącznikami

Na tej stronie znajdują się szczegółowe informacje o wdrażaniu tworzenia załączników i pracy z pracami nadsyłanymi przez uczniów. Podczas tworzenia tych żądań konieczne może być podanie parametrów związanych z załącznikami.

Utwórz załącznik

Utwórz załącznik, wysyłając żądanie CREATE do odpowiedniego punktu końcowego courses.*.addOnAttachments.create. W treści żądania musi znajdować się wystąpienie elementu AddOnAttachment.

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

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

Możesz uwzględnić niektóre z tych pól opcjonalnych:

  • dueDate i dueTime, jeśli określasz termin załącznika.
  • maxPoints: maksymalna ocena za załącznik. Jeśli chcesz obsługiwać przebieg zwrotny ocen, musi być wartość różna od zera. Dotyczy tylko 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 obejmuje te kroki:

  1. Uczeń uruchamia studentViewUri, aby ukończyć zadanie.
  2. Dodatek pobiera submissionId z metody getAddOnContext za pomocą danych logowania ucznia.
  3. Kody 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 z tych 2 parametrów, aby wyświetlić nowy załącznik w skopiowanym projekcie. Więcej informacji znajdziesz na naszej stronie poświęconej kopiowanej treści.
  4. Nauczyciel, który chce sprawdzać prace uczniów, uruchamia aplikację studentWorkReviewUri. Żądanie zawiera te parametry zapytania: courseId, itemId, itemType, attachmentId i submissionId.
  5. Programista 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 przesłaniu przez ucznia.

Wykrywaj stan przesyłania

Wyślij żądanie GET do punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions, aby uzyskać szczegółowe informacje o konkretnym submissionId. Otrzymasz obiekt AddOnAttachmentStudentSubmission zawierający ocenę (pointsEarned) i bieżący stan zadania (postSubmissionState). Stan zadania 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ń oddał swoje zadanie nauczycielowi.
  • RETURNED, jeśli nauczyciel zwrócił zadanie uczniowi.
  • RECLAIMED_BY_STUDENT, jeśli uczeń „cofnął” swoje zadanie.

Użyj tego punktu końcowego, aby wykrywać stan zadania ucznia w dodatku. Następnie możesz dostosować widoki lub opcje dostępne dla ucznia w zależności od zwróconego stanu. Może to obejmować:

  • Wyświetlanie stanu oddania projektów w dodatku. Pomoże to uczniom uniknąć pomyłek i uniknąć przypadkowego oddania projektu.
  • Ograniczam uprawnienia do edycji przesłanych zadań. Jeśli projekt ma stan CREATED lub RECLAIMED_BY_STUDENT, uczeń może mieć możliwość edytowania swojego projektu. Jeśli projekt ma stan TURNED_IN lub RETURNED, uczeń może nie mieć możliwości edytowania swojego projektu.

Oceny i wiele załączników

Do ustawienia oceny jednego projektu można użyć tylko 1 załącznika dodatku. Jeśli nauczyciel utworzy więcej niż 1 załącznik do aktywności, który przekazuje wartość maxPoints, tylko pierwszy z tych załączników może ustawić ocenę za projekt. Pozostaw wartość maxPoints nieskonfigurowaną lub ustaw ją na 0, aby wyłączyć przebieg zwrotny ocen dla załącznika.

Ustawianie oceny za zadanie

Możesz zmodyfikować zadanie przesłane przez ucznia, wysyłając żądanie PATCH do punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions. Treść żądania musi zawierać instancję AddOnAttachmentStudentSubmission ze zmodyfikowanymi wartościami. Aby zmienić ocenę za zadanie, wypełnij pole pointsEarned. Wartość przekazana w pointsEarned staje się oceną roboczą widoczną dla nauczyciela w interfejsie Classroom. Przed zwróceniem projektu uczniowi nauczyciel może zmienić wersję roboczą. Więcej informacji o sposobie prezentowania ocen nauczycielom znajdziesz w artykule Omówienie oceniania w interfejsie Classroom.

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

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

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

Kiedy ustawić ocenę

Możesz wybrać, kiedy ocena ma być przekazywana z powrotem do Google Classroom. Krytyczna różnica polega na tym, że zdecydujesz się przechowywać dane logowania nauczyciela, ponieważ tylko nauczyciel może modyfikować ocenę.

Istnieją 2 dodatkowe momenty, w których możesz przekazywać ocenę do Google Classroom: gdy uczeń ukończy pracę lub gdy nauczyciel otworzy zadanie ucznia w elemencie iframe z ocenami zadań uczniów.

Jeśli chcesz wystawiać oceny, gdy uczeń ukończy zadanie, musisz zapisać dane logowania offline nauczyciela, a następnie pobrać je i używać do modyfikowania oceny, gdy uczeń ukończy zadanie. Ta metoda przynosi pewne korzyści:

  • Bezproblemowe aktualizowanie ocen. Aby oceny pojawiły się w interfejsie Classroom, nauczyciele nie muszą podejmować żadnych specjalnych działań.
  • Zapewnij w czasie rzeczywistym wgląd w postępy na zajęciach w ramach projektu. Dzięki ustawieniu ocen w trakcie dodawania załączników przez uczniów nauczyciele mogą dowiedzieć się więcej o zrozumieniu uczniów bez otwierania każdego zadania.

Pamiętaj, że takie podejście umożliwia też asynchroniczne synchronizowanie ocen. Możesz co jakiś czas przeprowadzać ankietę w punkcie końcowym AddOnAttachmentStudentSubmission, aby sprawdzać, czy uczeń oddał zadanie. Po przesłaniu zadania ustaw jego ocenę za pomocą zapisanych danych logowania.

Jeśli nie chcesz wczytywać danych logowania nauczyciela podczas sesji ucznia, możesz użyć danych logowania aktywnego nauczyciela podczas wczytywania prac ucznia w elemencie iframe do sprawdzania zadań uczniów. Może to jednak nie być zbyt wygodne, ponieważ oceny w interfejsie Classroom nie są aktualizowane w czasie rzeczywistym, a nauczyciele będą musieli otwierać element iframe z przeglądem zadań uczniów w każdym zgłoszeniu.

Wykrywanie zmian w ocenach za projekty

po utworzeniu projektu nauczyciele mogą zmienić ustawienia oceniania w Classroom. Takie zmiany mogą obejmować:

  • Zmiana przypisanej liczby punktów.
  • Zmieniam wartość maxPoints projektu.
  • wybór, czy projekt ma być w ogóle oceniany;

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

Jeśli ocena została oddana z powrotem do Classroom, użyj punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions, aby pobrać lub zmienić ocenę w załączniku dodatku. Wartość oceny jest ustawiana w polu pointsEarned. Rozważ sprawdzenie i w razie potrzeby zaktualizowanie tej wartości, jeśli Twoja usługa umożliwia nauczycielom edytowanie oceny ucznia za konkretną aktywność.