Interakcja z załącznikami

Ta strona zawiera informacje o tworzeniu załączników i pracy z przesł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. Żądanie musi zawierać wystąpienie elementu AddOnAttachment w treści żądania.

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

• title: ciąg znaków z nazwą załącznika.
• teacherViewUri: identyfikator URI widoku nauczyciela załącznika.
• studentViewUri: identyfikator URI widoku ucznia 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ć niektóre z tych pól opcjonalnych:

• dueDate i dueTime, jeśli określasz termin dostarczenia 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łanego przez ucznia zadania

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

1. Uczeń uruchamia studentViewUri, aby wykonać zadanie.
2. Wtyczka pobiera submissionId z metody getAddOnContext, używając danych logowania ucznia.
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 przesłanym przez ucznia zadaniu.

Wykrywanie stanu przesyłania

Aby uzyskać szczegółowe informacje o konkretnym submissionId, prześlij żądanie GET do punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions. Otrzymasz obiekt AddOnAttachmentStudentSubmission, który zawiera ocenę przesyłania (pointsEarned) i jego bieżący stan (postSubmissionState). Stan przesył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ł projekt 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; Może to pomóc uczniom uniknąć nieporozumień i upewnić się, że nie zapomną przesłać 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 określać ocenę projektu. Aby wyłączyć przekazywanie ocen dla załącznika, pozostaw wartość maxPoints nieustawioną lub ustaw ją na 0.

Ustawianie oceny przesłania

Możesz zmienić przesłane przez ucznia zadanie, wysyłając żądanie PATCH do punktu końcowego courses.courseWork.addOnAttachments.studentSubmissions. Treść żądania musi zawierać instancję AddOnAttachmentStudentSubmission z zmienionymi wartościami. Aby zmienić ocenę przesłania, ustaw pole pointsEarned. Wartość przekazana w pointsEarned staje się wersją roboczą oceny widoczną dla nauczyciela w interfejsie Classroom. Nauczyciele mogą modyfikować ocenę roboczą przed zwróceniem projektu uczniom. Więcej informacji o tym, jak oceny są prezentowane nauczycielom, znajdziesz w artykule Omówienie wystawiania ocen 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 zmodyfikować wartość maxPoints parametru AddOnAttachment w już utworzonej jednostce AddOnAttachment, wysyłając do punktu końcowego addOnAttachments żądanie PATCH.

Kiedy ustawić ocenę

Możesz wybrać, kiedy ocena zostanie przesłana do Google Classroom. Kluczową kwestią jest to, czy chcesz przechowywać dane logowania nauczyciela, ponieważ tylko nauczyciel 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 ustawiać oceny, gdy uczeń ukończy pracę, musisz przechowywać dane logowania nauczyciela w trybie offline, a następnie pobrać je i użyć, aby zmodyfikować ocenę, gdy uczeń ukończy pracę. Ta metoda może przynieść następujące korzyści:

• Automatyczne aktualizowanie ocen. Nauczyciele nie muszą wykonywać żadnych specjalnych czynności, aby oceny były wyświetlane 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 ocenianie synchronizacji. Możesz okresowo sprawdzać punkt końcowy AddOnAttachmentStudentSubmission, aby wykryć, kiedy uczeń przesłał swoje zadanie. Po przesłaniu zadania ustaw jego ocenę, korzystając z 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 przesłanie ucznia w ramce iframe Sprawdzania prac uczniów. Może to jednak nie zapewnić szczególnie płynnego korzystania z usługi, ponieważ oceny w interfejsie Classroom nie będą aktualizowane w czasie rzeczywistym, a nauczyciele będą musieli otwierać iframe Sprawdzania prac uczniów dla każdego przesłanego projektu.

Wykrywanie zmian w ocenach projektów

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

• Zmiana przypisanej liczby punktów.
• Zmiana wartości maxPoints projektu.
• Zmiana tego, czy zadanie ma być oceniane.

Aby wyświetlić bieżące ustawienia oceniania zadania, wyślij 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ą.