- Zasób: StudentSubmission
- RubricGrade
- AssignmentSubmission
- Załącznik
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory (Historia przesyłania)
- StateHistory
- Stan
- GradeHistory (Historia ocen)
- GradeChangeType
- Metody
Zasób: StudentSubmission
Przesłane przez ucznia do zadania.
Podczas tworzenia elementu CourseWork
generowanych jest StudentSubmission
elementów.
Zadania przesłane przez uczniów, które nigdy nie były otwierane (np. z wartością state
= NOWE), mogą nie mieć podanego czasu utworzenia lub aktualizacji.
Zapis JSON |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
Pola | |
---|---|
courseId |
Identyfikator zajęć. Tylko do odczytu. |
courseWorkId |
Identyfikator zadania związanego z kursem. Tylko do odczytu. |
id |
Identyfikator zadania przesłanego przez ucznia. Nie można ich znaleźć wśród innych zgłoszeń dotyczących danego zadania w ramach kursu. Tylko do odczytu. |
userId |
Identyfikator ucznia, do którego należy przesłane zadanie. Tylko do odczytu. |
creationTime |
Data utworzenia tego zgłoszenia. Ta opcja może być nieskonfigurowana, jeśli uczeń nie miał dostępu do tego elementu. Tylko do odczytu. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
updateTime |
Data ostatniej aktualizacji tego zgłoszenia. Ta opcja może być nieskonfigurowana, jeśli uczeń nie miał dostępu do tego elementu. Tylko do odczytu. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
state |
Stan tego zgłoszenia. Tylko do odczytu. |
late |
Określa, czy zadanie zostało przesłane po terminie. Tylko do odczytu. |
draftGrade |
Opcjonalna ocena oczekująca. Jeśli zasada jest nieskonfigurowana, nie określono żadnej oceny. Ta wartość musi być liczbą nieujemną. Wartości dziesiętne (nie całkowite) są dozwolone, ale są zaokrąglane do dwóch miejsc po przecinku. Tylko nauczyciele zajęć widzą i mogą ją modyfikować. |
assignedGrade |
Ocena opcjonalna. Jeśli zasada jest nieskonfigurowana, nie określono żadnej oceny. Ta wartość musi być liczbą nieujemną. Wartości dziesiętne (nie całkowite) są dozwolone, ale są zaokrąglane do dwóch miejsc po przecinku. Tę opcję mogą zmieniać tylko nauczyciele zajęć. |
rubricId |
Tylko dane wyjściowe. Identyfikator oceny cząstkowej aktualnie dołączonej do tego zadania w ramach zajęć i używanej do oceniania tego zadania przesłanego przez ucznia. Jeśli nie ma oceny cząstkowej, identyfikator jest pusty. Ten identyfikator odzwierciedla obecnie aktywną ocenę cząstkową. Zmienia się, jeśli nauczyciele usuną i ponownie utworzy ocenę cząstkową. Tylko do odczytu. |
draftRubricGrades |
Oczekujące oceny cząstkowe na podstawie kryteriów oceny cząstkowej. Ta mapa jest pusta, jeśli do zadania nie dołączono oceny cząstkowej lub jeśli do zadania jest dołączona ocena cząstkowa, ale dla żadnych kryteriów nie ustawiono ocen cząstkowych. Wpisy są wypełniane tylko w przypadku ustawionych ocen. Klucz: identyfikator kryterium oceny cząstkowej. Tylko do odczytu. Obiekt zawierający listę par |
assignedRubricGrades |
Przypisano oceny cząstkowe na podstawie kryteriów oceny cząstkowej. Ta mapa jest pusta, jeśli do zadania w ramach zajęć nie dołączono oceny cząstkowej lub jeśli dołączona jest ocena cząstkowa, ale nie ustawiono żadnej oceny dla żadnego kryterium. Wpisy są wypełniane tylko w przypadku ustawionych ocen. Klucz: identyfikator kryterium oceny cząstkowej. Tylko do odczytu. Obiekt zawierający listę par |
alternateLink |
Bezwzględny link do zadania w interfejsie internetowym Classroom. Tylko do odczytu. |
courseWorkType |
Typ zadania, którego dotyczy to zgłoszenie. Tylko do odczytu. |
associatedWithDeveloper |
Określa, czy to zadanie przesłane przez ucznia jest powiązane z projektem w Konsoli programisty, z którego pochodzi prośba. Więcej informacji: Tylko do odczytu. |
submissionHistory[] |
historię przesłanych zadań (w tym historie stanów i ocen). Tylko do odczytu. |
previewVersion |
Tylko dane wyjściowe. Wersja testowa interfejsu API. Ten parametr należy skonfigurować, aby uzyskać dostęp do nowych funkcji interfejsu API udostępnianych deweloperom w ramach Programu testowania aktualizacji. |
Pole sumy content . Treść zgłoszenia. Konkretny typ zależy od wartości course_work_type . content może mieć tylko jedną z tych wartości: |
|
assignmentSubmission |
Treść przesłanej pracy, gdy obiekt sessionWorkType ma wartość ASSIGNMENT. Uczniowie mogą modyfikować te treści za pomocą narzędzia |
shortAnswerSubmission |
Treść zadania, gdy typ polakursu ma wartość SHORT_ANSWER_QUESTION. |
multipleChoiceSubmission |
Treść przesłanej pracy, gdy obiekt sessionWorkType ma wartość MULTIPLE_CHOICE_QUESTION. |
RubricGrade
Zestaw ocen cząstkowych za zadanie przesłane przez ucznia. Na każde kryterium oceny cząstkowej przypada maksymalnie 1 wpis.
Zapis JSON |
---|
{ "criterionId": string, "levelId": string, "points": number } |
Pola | |
---|---|
criterionId |
Opcjonalnie. Identyfikator kryterium. |
levelId |
Opcjonalnie. Opcjonalny identyfikator wybranego poziomu. Jeśli pole jest puste, nie wybrano żadnego poziomu. |
points |
Opcjonalnie. Punkty opcjonalne przypisane do tego kryterium, zwykle na podstawie poziomu. Poziomy mogą nie mieć punktów. Jeśli zasada jest nieskonfigurowana, dla tego kryterium nie są przyznawane żadne punkty. |
AssignmentSubmission
zadania uczniów związane z projektem,
Zapis JSON |
---|
{
"attachments": [
{
object ( |
Pola | |
---|---|
attachments[] |
Załączniki dodane przez ucznia. Jeśli uczeń nie otwierał projektu w Classroom, mogą jeszcze nie istnieć pliki na Dysku odpowiadające materiałom z trybem udostępniania STUDENT_COPY. Niektóre metadane załącznika są wypełniane tylko wtedy, gdy użytkownik wysyłający prośbę ma uprawnienia dostępu do nich. Pola Identifier i alternateLink są zawsze dostępne, ale inne (np. tytuł) mogą nie być dostępne. |
Przywiązanie
Załącznik został dodany do zadania ucznia.
Podczas tworzenia załączników ustawienie pola form
nie jest obsługiwane.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy attachment . Dane załączników. attachment może mieć tylko jedną z tych wartości: |
|
driveFile |
Plik załącznika z Dysku Google. |
youTubeVideo |
Załącznik wideo w YouTube. |
link |
Załącznik z linkiem. |
form |
Załącznik Formularzy Google. |
ShortAnswerSubmission
Praca ucznia nad pytaniem z krótką odpowiedzią.
Zapis JSON |
---|
{ "answer": string } |
Pola | |
---|---|
answer |
Odpowiedź ucznia na pytanie z krótką odpowiedzią. |
MultipleChoiceSubmission
Uczniowie pracują nad pytaniem jednokrotnego wyboru.
Zapis JSON |
---|
{ "answer": string } |
Pola | |
---|---|
answer |
Wybór ucznia. |
SubmissionHistory
historię zgłoszenia. Obecnie obejmuje to historie stanów i ocen.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy type . Typ SubmissionHistory może mieć wartość StateHistory lub GradeHistory. type może mieć tylko jedną z tych wartości: |
|
stateHistory |
Historia stanu zgłoszenia (jeśli jest dostępna). |
gradeHistory |
informacje o historii ocen przesłanej aplikacji (jeśli są dostępne). |
StateHistory
Historia każdego stanu, w którym znajduje się to zgłoszenie.
Zapis JSON |
---|
{
"state": enum ( |
Pola | |
---|---|
state |
Etap potoku przepływu pracy. |
stateTimestamp |
Kiedy przesłane treści mają ten stan. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
actorUserId |
nauczyciel lub uczeń, który wprowadził zmianę; |
Stan
Możliwe stany, w których znajduje się zgłoszenie.
Wartości w polu enum | |
---|---|
STATE_UNSPECIFIED |
Nie określono stanu. Ten kod nie powinien być zwracany. |
CREATED |
Zgłoszenie zostało utworzone. |
TURNED_IN |
Uczeń oddał przypisany dokument, który może, ale nie być szablonem. |
RETURNED |
Nauczyciel zwrócił przypisany dokument uczniowi. |
RECLAIMED_BY_STUDENT |
Uczeń oddał przypisany dokument, a następnie zdecydował się „wycofać” projekt, dając mu ponownie kontrolę jako właściciel. |
STUDENT_EDITED_AFTER_TURN_IN |
Uczeń edytował swoje zadanie po oddaniu. Obecnie jest używany tylko w przypadku pytań, gdy uczeń edytuje swoją odpowiedź. |
GradeHistory
Historia poszczególnych ocen za zadanie.
Zapis JSON |
---|
{
"pointsEarned": number,
"maxPoints": number,
"gradeTimestamp": string,
"actorUserId": string,
"gradeChangeType": enum ( |
Pola | |
---|---|
pointsEarned |
Licznik oceny obecny w historii ocen przesłanych zadań. |
maxPoints |
Mianownik oceny obecny w historii ocen zadań. |
gradeTimestamp |
Data zmiany oceny za zadanie. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
actorUserId |
nauczyciela, który zmienił ocenę. |
gradeChangeType |
Typ zmiany oceny, która pojawia się obecnie w historii ocen przesłanych zadań. |
GradeChangeType
Możliwe typy zmian ocen.
Wartości w polu enum | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
Nie określono typu zmiany oceny. Ten kod nie powinien być zwracany. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
Zmiana licznika oceny roboczej. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
Zmiana licznika przypisanej oceny. |
MAX_POINTS_CHANGE |
Zmiana mianownika oceny. |
Metody |
|
---|---|
|
Zwraca zadanie przesłane przez ucznia. |
|
Zwraca listę zadań uczniów, które osoba zgłaszająca może przeglądać, z uwzględnieniem zakresów OAuth żądania. |
|
Modyfikuje załączniki przesłane przez ucznia. |
|
Aktualizuje co najmniej jedno pole zadania przesłanego przez ucznia. |
|
Odzyskuje zadanie przesłane przez ucznia w imieniu ucznia, który jest właścicielem. |
|
Zwraca zadanie przesłane przez ucznia. |
|
Odda zadanie przesłane przez ucznia. |