REST Resource: courses.courseWork.studentSubmissions

Zasób: StudentSubmission

Zadanie przesłane przez ucznia w ramach zadania.

Elementy StudentSubmission są generowane podczas tworzenia elementu CourseWork.

Prace uczniów, które nigdy nie były otwierane (czyli mają stan state = NEW), mogą nie mieć czasu utworzenia ani czasu aktualizacji.

Zapis JSON 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
Pola
courseId

string

Identyfikator kursu.

Tylko do odczytu.
courseWorkId

string

Identyfikator zadania, którego dotyczy ta ocena.

Tylko do odczytu.
id

string

Identyfikator przypisany przez Classroom do zadania ucznia. Jest on unikalny wśród projektów przesłanych w ramach danego zadania.

Tylko do odczytu.
userId

string

Identyfikator ucznia, który jest właścicielem tego zadania.

Tylko do odczytu.
creationTime

string (Timestamp format)

Czas utworzenia tego zgłoszenia. Ta wartość może być nieustawiona, jeśli uczeń nie uzyskał dostępu do tego elementu.

Tylko do odczytu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Czas ostatniej aktualizacji tego zgłoszenia. Ta wartość może być nieustawiona, jeśli uczeń nie uzyskał dostępu do tego elementu.

Tylko do odczytu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

Stan tego zgłoszenia.

Tylko do odczytu.
late

boolean

Określa, czy zadanie zostało przesłane po czasie.

Tylko do odczytu.
draftGrade

number

Opcjonalna oczekująca ocena. Jeśli nie jest ustawiona, nie ustawiono oceny. Ta wartość musi być liczbą nieujemną. Dozwolone są wartości dziesiętne (czyli niecałkowite), ale są one zaokrąglane do 2 miejsc po przecinku.

Są one widoczne tylko dla nauczycieli prowadzących zajęcia i tylko oni mogą je modyfikować.
assignedGrade

number

Opcjonalna ocena. Jeśli nie jest ustawiona, nie ustawiono oceny. Ta wartość musi być liczbą nieujemną. Dozwolone są wartości dziesiętne (czyli niecałkowite), ale są one zaokrąglane do 2 miejsc po przecinku.

Może to zmienić tylko nauczyciel prowadzący zajęcia.
rubricId

string

Tylko dane wyjściowe. Identyfikator oceny cząstkowej dołączonej obecnie do tego zadania i używanej do oceniania tego zadania ucznia.

Jeśli nie ma oceny cząstkowej, ten identyfikator jest pusty. Ten identyfikator odzwierciedla obecnie aktywny oceny cząstkowe. Zmienia się, gdy nauczyciele usuną i ponownie utworzą oceny cząstkowe.

Tylko do odczytu.

draftRubricGrades

map (key: string, value: object (RubricGrade))

Oczekujące oceny cząstkowe na podstawie kryteriów oceny cząstkowej.

Ta mapa jest pusta, jeśli do zadania nie jest dołączona ocena cząstkowa lub jeśli ocena cząstkowa jest dołączona, ale nie ustawiono ocen dla żadnych kryteriów. Wpisy są wypełniane tylko w przypadku ustawionych ocen. Klucz: identyfikator kryterium oceny cząstkowej.

Tylko do odczytu.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }
assignedRubricGrades

map (key: string, value: object (RubricGrade))

Przypisane oceny cząstkowe na podstawie kryteriów oceny cząstkowej.

Ta mapa jest pusta, jeśli do zadania nie jest dołączona ocena cząstkowa lub jeśli ocena cząstkowa jest dołączona, ale nie ustawiono żadnych ocen 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 "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }
courseWorkType

enum (CourseWorkType)

Typ zadania, którego dotyczy to przesłanie.

Tylko do odczytu.
associatedWithDeveloper

boolean

Określa, czy to zadanie ucznia jest powiązane z projektem w Konsoli programisty, który wysyła żądanie.

Więcej informacji znajdziesz na stronie courseWork.create.

Tylko do odczytu.
submissionHistory[]

object (SubmissionHistory)

Historia przesłanego zadania (obejmuje historię stanu i ocen).

Tylko do odczytu.
previewVersion

enum (PreviewVersion)

Tylko dane wyjściowe. Wersja testowa interfejsu API. Należy go ustawić, aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w programie testów wersji przedpremierowej.
Treść zgłoszenia. Konkretny typ zależy od wartości course_work_type. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
assignmentSubmission

object (AssignmentSubmission)

Treść przesłanego zadania, gdy courseWorkType to ASSIGNMENT.

Uczniowie mogą modyfikować te treści za pomocą studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Treść zadania, gdy courseWorkType to SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Treść zadania, gdy courseWorkType to MULTIPLE_CHOICE_QUESTION.
Koniec pól wykluczających się wzajemnie.

RubricGrade

Ocena cząstkowa ustawiona dla zadania przesłanego przez ucznia. Może być maksymalnie 1 wpis na kryterium oceny cząstkowej.

Zapis JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Pola
criterionId

string

Opcjonalnie: Identyfikator kryterium.
levelId

string

Opcjonalnie: Opcjonalny identyfikator wybranego poziomu. Jeśli pole jest puste, nie wybrano żadnego poziomu.
points

number

Opcjonalnie: Opcjonalne punkty przypisane do tego kryterium, zwykle na podstawie poziomu. Poziomy mogą, ale nie muszą, mieć punkty. Jeśli nie jest ustawiona, nie ustawiono żadnych punktów dla tego kryterium.

AssignmentSubmission

zadania uczniów w ramach projektu,

Zapis JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Pola
attachments[]

object (Attachment)

załączniki dodane przez ucznia, Pliki na Dysku, które odpowiadają materiałom z trybem udostępniania STUDENT_COPY, mogą jeszcze nie istnieć, jeśli uczeń nie uzyskał dostępu do projektu w Classroom.

Niektóre metadane załącznika są wypełniane tylko wtedy, gdy użytkownik wysyłający żądanie ma uprawnienia dostępu do nich. Pola identifier i alternateLink są zawsze dostępne, ale inne (np. title) mogą nie być.

Załącznik

Załącznik został dodany do przypisanego zadania ucznia.

Podczas tworzenia załączników ustawianie pola form nie jest obsługiwane.

Zapis JSON 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
Pola
Dane załącznika. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
driveFile

object (DriveFile)

Załącznik z Dysku Google.
youTubeVideo

object (YouTubeVideo)

Załącznik z filmem na YouTube.
form

object (Form)

załącznik z Formularzy Google,
Koniec pól wykluczających się wzajemnie.

ShortAnswerSubmission

Praca ucznia dotycząca pytania z krótką odpowiedzią.

Zapis JSON 
{
  "answer": string
}
Pola
answer

string

Odpowiedź ucznia na pytanie z krótką odpowiedzią.

MultipleChoiceSubmission

Zadanie ucznia z pytaniem jednokrotnego wyboru.

Zapis JSON 
{
  "answer": string
}
Pola
answer

string

Wybór ucznia.

SubmissionHistory

Historia przesyłania. Obecnie obejmuje to historię stanów i ocen.

Zapis JSON 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
Pola
Typ SubmissionHistory, może być jednym z tych typów: StateHistory, GradeHistory. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
stateHistory

object (StateHistory)

Informacje o historii stanu zgłoszenia, jeśli są dostępne.
gradeHistory

object (GradeHistory)

Informacje o historii ocen przesłanego projektu, jeśli są dostępne.
Koniec pól wykluczających się wzajemnie.

StateHistory

Historia wszystkich stanów, w których znajdowało się to zgłoszenie.

Zapis JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Pola
state

enum (State)

Etap potoku przepływu pracy.
stateTimestamp

string (Timestamp format)

Kiedy zgłoszenie zostało przesłane.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
actorUserId

string

nauczyciela lub ucznia, który wprowadził zmianę;

Stan

Możliwe stany zadania.

Wartości w polu enum
STATE_UNSPECIFIED Nie podano stanu. Ta wartość nie powinna być nigdy zwracana.
CREATED Zgłoszenie zostało utworzone.
TURNED_IN Uczeń oddał przypisany dokument, który może być szablonem.
RETURNED Nauczyciel zwrócił uczniowi przypisany dokument.
RECLAIMED_BY_STUDENT Uczeń oddał przypisany dokument, a następnie zdecydował się na „cofnięcie przesłania” projektu, co przywróciło mu kontrolę nad dokumentem jako właścicielowi.
STUDENT_EDITED_AFTER_TURN_IN Uczeń edytował przesłane zadanie po jego oddaniu. Obecnie używane tylko w przypadku pytań, gdy uczeń edytuje swoją odpowiedź.

GradeHistory

Historia każdej oceny tego zadania.

Zapis JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
Pola
pointsEarned

number

Licznik oceny w tym momencie w historii ocen przesyłania.
maxPoints

number

Mianownik oceny w tym momencie w historii ocen przesyłania.
gradeTimestamp

string (Timestamp format)

Kiedy ocena przesłanego projektu została zmieniona.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
actorUserId

string

nauczyciela, który zmienił ocenę;
gradeChangeType

enum (GradeChangeType)

Typ zmiany oceny w tym momencie w historii ocen zadania.

GradeChangeType

Możliwe typy zmian ocen.

Wartości w polu enum
UNKNOWN_GRADE_CHANGE_TYPE Nie określono typu zmiany oceny. Ta wartość nie powinna być nigdy zwracana.
DRAFT_GRADE_POINTS_EARNED_CHANGE zmiana licznika oceny wersji roboczej,
ASSIGNED_GRADE_POINTS_EARNED_CHANGE zmiana licznika przypisanej oceny,
MAX_POINTS_CHANGE zmianę mianownika oceny,

Metody

get

 Zwraca zadanie przesłane przez ucznia.

list

 Zwraca listę zadań uczniów, które osoba wysyłająca żądanie może wyświetlić, uwzględniając zakresy protokołu OAuth żądania.

modifyAttachments

 Modyfikuje załączniki do zadania przesłanego przez ucznia.

patch

 Aktualizuje co najmniej jedno pole zadania przesłanego przez ucznia.

reclaim

 Zwraca przesłane zadanie w imieniu ucznia, który jest jego właścicielem.

return

 Zwraca zadanie przesłane przez ucznia.

turnIn

 Oddaje zadanie przesłane przez ucznia.