REST Resource: courses.courseWork.studentSubmissions

Zasób: StudentSubmission

Zadanie przesłane przez ucznia.

Podczas tworzenia elementu CourseWork generowane są StudentSubmission elementy.

Zadania uczniów, które nie były nigdy wcześniej dostępne (np. z oznaczeniem state = NOWE), mogą nie mieć czasu utworzenia lub 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),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
Pola
courseId

string

Identyfikator zajęć.

Tylko do odczytu.
courseWorkId

string

Identyfikator zadania, którego dotyczy kurs.

Tylko do odczytu.
id

string

Przypisany przez Classroom identyfikator zadania przesłanego przez ucznia. Jest to unikalne wśród zgłoszeń dotyczących danego zadania.

Tylko do odczytu.
userId

string

Identyfikator ucznia, do którego należy zadanie.

Tylko do odczytu.
creationTime

string (Timestamp format)

Czas utworzenia tego elementu. Jeśli uczeń nie uzyskał dostępu do tego elementu, ta opcja może być nieskonfigurowana.

Tylko do odczytu.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Ostatnia aktualizacja tego elementu. Jeśli uczeń nie uzyskał dostępu do tego elementu, ta opcja może być nieskonfigurowana.

Tylko do odczytu.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
state

enum (SubmissionState)

Stan tego elementu.

Tylko do odczytu.
late

boolean

Określa, czy ten termin minął.

Tylko do odczytu.
draftGrade

number

Opcjonalna ocena oczekująca. Jeśli zasada jest nieskonfigurowana, nie ustawiono oceny. Ta wartość musi być liczbą nieujemną. Wartości dziesiętne (inne niż całkowite) są dozwolone, ale są zaokrąglane do dwóch miejsc po przecinku.

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

number

Ocena opcjonalna. Jeśli zasada jest nieskonfigurowana, nie ustawiono oceny. Ta wartość musi być liczbą nieujemną. Wartości dziesiętne (inne niż całkowite) są dozwolone, ale są zaokrąglane do dwóch miejsc po przecinku.

Tylko nauczyciele mogą go zmienić.
rubricId

string

Tylko dane wyjściowe. Identyfikator oceny cząstkowej aktualnie dołączonej do tego zadania w ramach tego kursu i używanej do oceniania tego zadania przesłanego przez ucznia.

Jeśli nie ma oceny cząstkowej, identyfikator jest pusty. Ten identyfikator odzwierciedla aktualnie aktywną ocenę cząstkową. zmieni się, gdy nauczyciele usuną ocenę cząstkową i utworzą ją ponownie.

Tylko do odczytu.

draftRubricGrades

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

Oczekujące oceny cząstkowe oparte na kryteriach oceny cząstkowej.

Jeśli do tego zadania nie dołączono oceny cząstkowej lub dołączono ocenę cząstkową, ale dla kryteriów nie ustawiono ocen, mapa jest pusta. Wpisy są wypełniane tylko w przypadku ocen, które zostały ustawione. 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))

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

Jeśli do tego zadania nie dołączono oceny cząstkowej lub dołączono ocenę cząstkową, ale dla kryteriów nie ustawiono ocen, mapa jest pusta. Wpisy są wypełniane tylko w przypadku ocen, które zostały ustawione. 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 szkoleniowego, którego dotyczy to zgłoszenie.

Tylko do odczytu.
associatedWithDeveloper

boolean

Określa, czy zadanie przesłane przez ucznia jest powiązane z projektem w Konsoli programisty przesyłającym prośbę.

Aby dowiedzieć się więcej, wejdź na courseWork.create.

Tylko do odczytu.
submissionHistory[]

object (SubmissionHistory)

historię zadania (obejmuje historię stanów i ocen);

Tylko do odczytu.
previewVersion

enum (PreviewVersion)

Tylko dane wyjściowe. Wersja testowa interfejsu API. Jest ono wymagane, aby można było korzystać z nowych funkcji interfejsu API udostępnianych deweloperom w programie testowania wersji przedpremierowej.
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

object (AssignmentSubmission)

Przesyłaj treść, gdy obiektcourseWorkType ma wartość ASSIGNMENT.

Uczniowie mogą modyfikować tę treść za pomocą studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Przesyłaj treść, gdy typcourseWorkType to SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Przesyłaj treść, gdy obiektcourseWorkType ma wartość MULTIPLE_CHOICE_QUESTION.

RubricGrade

Ocena cząstkowa za zadanie przesłane przez ucznia. Dla każdego kryterium oceny cząstkowej można podać maksymalnie 1 wpis.

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

string

Opcjonalnie: Identyfikator kryterium.
levelId

string

Opcjonalnie: Opcjonalny identyfikator wybranego poziomu. Jeśli ta kolumna jest pusta, nie wybrano żadnego poziomu.
points

number

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

AssignmentSubmission

Zadania uczniów w projekcie.

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

object (Attachment)

Załączniki dodane przez ucznia. Pliki na Dysku odpowiadające materiałom w trybie udostępniania STUDENT_copy mogą jeszcze nie istnieć, jeśli uczeń nie otworzył projektu w Classroom.

Niektóre metadane załączników są wypełniane tylko wtedy, gdy użytkownik wysyłający prośbę ma do nich uprawnienia. Pola Identyfikator i alternatywny link są zawsze dostępne, ale inne (np. tytuł) mogą nie być dostępne.

Załącznik

Do zadań uczniów dodano załącznik.

Podczas tworzenia załączników nie można ustawiać pola form.

Zapis JSON 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
Pola
Pole sumy attachment. Dane załączników. attachment może mieć tylko jedną z tych wartości:
driveFile

object (DriveFile)

Załącznik pliku z Dysku Google.
youTubeVideo

object (YouTubeVideo)

Załącznik wideo w YouTube.
form

object (Form)

Załącznik do Formularzy Google.

ShortAnswerSubmission

Zadania uczniów na pytanie z krótką odpowiedzią.

Zapis JSON 
{
  "answer": string
}
Pola
answer

string

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

MultipleChoiceSubmission

Zadania uczniów na pytanie jednokrotnego wyboru.

Zapis JSON 
{
  "answer": string
}
Pola
answer

string

Wybór ucznia.

SubmissionHistory

historię przesyłania. Obecnie obejmuje to historie stanów i klas.

Zapis JSON 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
Pola
Pole sumy type. Typ SubmissionHistory, może mieć wartość StateHistory, GradeHistory. type może mieć tylko jedną z tych wartości:
stateHistory

object (StateHistory)

Informacje o stanie zgłoszenia (jeśli są dostępne).
gradeHistory

object (GradeHistory)

informacje o historii ocen przesłanego zadania (jeśli są dostępne);

StateHistory

Historia każdego stanu, w którym znajdowało się to zadanie.

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

enum (State)

Etap potoku przepływu pracy.
stateTimestamp

string (Timestamp format)

kiedy treści pojawiły się w tym stanie;

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
actorUserId

string

nauczyciel lub uczeń, który wprowadził zmianę;

Stan

Możliwe stany, w których może znajdować się zgłoszenie.

Wartości w polu enum
STATE_UNSPECIFIED Nie określono stanu. Ta wartość nie powinna być nigdy zwracana.
CREATED Zgłoszenie zostało utworzone.
TURNED_IN Uczeń oddał przypisany dokument, który może, ale nie musi być szablonem.
RETURNED Nauczyciel zwrócił przydzielony dokument uczniowi.
RECLAIMED_BY_STUDENT Uczeń oddał przydzielony dokument, a następnie wybrał „Wycofaj zadanie” i dając uczniowi kontrolę nad projektem jako właściciela.
STUDENT_EDITED_AFTER_TURN_IN Uczeń edytował zadanie po jego oddaniu. Obecnie ta opcja jest używana tylko w przypadku pytań, gdy uczeń edytuje swoją odpowiedź.

GradeHistory

Historia poszczególnych ocen za to zadanie.

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

number

Licznik oceny przesłanej w danym momencie w historii ocen za przesłanie projektu.
maxPoints

number

Mianownik oceny w tym momencie w historii ocen przesłanych zadań.
gradeTimestamp

string (Timestamp format)

informacje o zmianie oceny zadania.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
actorUserId

string

Nauczyciel, który wprowadził zmianę oceny.
gradeChangeType

enum (GradeChangeType)

Typ zmiany oceny w historii przesłanych zadań.

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 roboczej.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Zmiana licznika przypisanej oceny.
MAX_POINTS_CHANGE Zmiana mianownika oceny.

Metody

get

 Zwraca zadanie przesłane przez ucznia.

list

 Zwraca listę zadań uczniów, które osoba zgłaszająca może przeglądać, z uwzględnieniem zakresów OAuth żądania.

modifyAttachments

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

patch

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

reclaim

 Odzyskuje zadanie przesłane przez ucznia w imieniu ucznia, do którego należy.

return

 Zwraca zadanie przesłane przez ucznia.

turnIn

 Przesyła zadanie przesłane przez ucznia.