REST Resource: courses.courseWork.studentSubmissions

Zasób: StudentSubmission

Zadanie przesłane przez ucznia.

StudentSubmission są generowane podczas tworzenia CourseWork.

Przesłane przez uczniów projekty, do których nigdy nie uzyskano dostępu (czyli oznaczone jako state = NOWE), 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),

  // 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 szkolenia.

Tylko do odczytu.
courseWorkId

string

Identyfikator zadania, którego dotyczy ta informacja.

Tylko do odczytu.
id

string

Identyfikator zadania ucznia przypisany w Classroom. Jest on niepowtarzalny wśród przesłanych prac w ramach danego zadania.

Tylko do odczytu.
userId

string

Identyfikator ucznia, do którego należy przesłana praca.

Tylko do odczytu.
creationTime

string (Timestamp format)

Czas utworzenia tego zgłoszenia. To pole może być puste, 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 używają 0, 3, 6 lub 9 cyfr ułamkowych. 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. To pole może być puste, 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 używają 0, 3, 6 lub 9 cyfr ułamkowych. 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 ocena oczekująca. Jeśli nie jest ustawiona, nie została przypisana żadna ocena. 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.

Jest on widoczny tylko dla nauczycieli kursu i mogą oni go modyfikować.
assignedGrade

number

Opcjonalna ocena. Jeśli nie jest ustawiona, nie została przypisana żadna ocena. 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 kurs.
rubricId

string

Tylko dane wyjściowe. Identyfikator arkusza oceniania, który jest obecnie dołączony do tego projektu i używany do oceniania przesłanego przez ucznia zadania.

Jeśli nie ma rubryki, ten identyfikator jest pusty. Ten identyfikator odzwierciedla obecnie aktywną rubrykę. Zmienia się, gdy nauczyciele usuną i ponownie utworzą rubrykę.

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 jest dołączona, ale nie ustawiono ocen dla żadnego kryterium. Wpisy są wypełniane tylko w przypadku ocen, które zostały ustawione. Klucz: identyfikator kryterium rubryki.

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 jest dołączona, ale nie ustawiono żadnych ocen dla kryteriów. Wpisy są wypełniane tylko w przypadku ocen, które zostały ustawione. Klucz: identyfikator kryterium rubryki.

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 przesłana praca.

Tylko do odczytu.
associatedWithDeveloper

boolean

Określa, czy przesłane przez ucznia zadanie jest powiązane z projektem w konsoli dewelopera, który wysyła żądanie.

Więcej informacji znajdziesz w sekcji courseWork.create.

Tylko do odczytu.
submissionHistory[]

object (SubmissionHistory)

historię przesłania (obejmuje historię stanu i ocen);

Tylko do odczytu.
previewVersion

enum (PreviewVersion)

Tylko dane wyjściowe. Wersja przedpremierowa interfejsu API. Musisz ustawić tę wartość, aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach programu podglądu.
Pole unii 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)

Treść przesłana, gdy courseWorkType to ASSIGNMENT.

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

object (ShortAnswerSubmission)

Treść przesłana, gdy courseWorkType to SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Treść przesłana, gdy courseWorkType to MULTIPLE_CHOICE_QUESTION.

RubricGrade

ocena częściowa za przesłane przez ucznia zadanie; Dla każdego kryterium oceny cząstkowej może być maksymalnie 1 wpis.

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

string

Opcjonalnie. Identyfikator kryterium.
levelId

string

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

number

Opcjonalnie. Opcjonalne punkty przypisane do tego kryterium, zwykle na podstawie poziomu. Poziomy mogą mieć punkty lub nie. Jeśli nie jest ustawiona, oznacza to, że dla tego kryterium nie przyznano żadnych punktów.

AssignmentSubmission

zadania uczniów w danym 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 uzyskał dostępu do projektu w Classroom.

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

Załącznik

Załącznik został dodany do projektu ucznia.

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

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 unii attachment. Dane załącznika. attachment może mieć tylko jedną z tych wartości:
driveFile

object (DriveFile)

załącznik z Dysku Google;
youTubeVideo

object (YouTubeVideo)

Załącznik wideo z YouTube.
form

object (Form)

załącznik z Formularzy Google,

ShortAnswerSubmission

Praca ucznia w przypadku pytania z krótką odpowiedzią.

Zapis JSON 
{
  "answer": string
}
Pola
answer

string

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

MultipleChoiceSubmission

Praca ucznia w przypadku pytania jednokrotnego wyboru.

Zapis JSON 
{
  "answer": string
}
Pola
answer

string

Wybór ucznia.

SubmissionHistory

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

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 unii type. Typ SubmissionHistory, może przyjmować wartości StateHistory lub GradeHistory. type może mieć tylko jedną z tych wartości:
stateHistory

object (StateHistory)

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

object (GradeHistory)

Informacje o historii ocen przesłanego projektu (jeśli są dostępne).

StateHistory

historię każdego stanu, w jakim znajdowało się przesłane 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 osiągnęło ten stan.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i używają 0, 3, 6 lub 9 cyfr ułamkowych. 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

Nauczyciel lub uczeń, który wprowadził zmianę.

Stan

Możliwe stany przesłanego zgłoszenia.

Wartości w polu enum
STATE_UNSPECIFIED Nie podano stanu. Nie powinno to nigdy zostać zwrócone.
CREATED Przesłany dokument został utworzony.
TURNED_IN Uczeń oddał przypisany dokument, który może być szablonem lub nie.
RETURNED Nauczyciel zwrócił uczniowi przypisany dokument.
RECLAIMED_BY_STUDENT Uczeń oddał przypisany dokument, a następnie cofnął oddanie projektu, dzięki czemu ponownie stał się właścicielem pliku.
STUDENT_EDITED_AFTER_TURN_IN Uczeń edytował przesłany projekt po jego oddaniu. Obecnie używane tylko w przypadku pytań, gdy uczeń edytuje swoją odpowiedź.

GradeHistory

historię każdej oceny przesłanego pliku.

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

number

Licznik oceny w tym momencie w historii ocen przesłanego projektu.
maxPoints

number

Mianownik oceny w tym momencie w historii ocen projektu.
gradeTimestamp

string (Timestamp format)

Gdy ocena przesłanej pracy została zmieniona.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i używają 0, 3, 6 lub 9 cyfr ułamkowych. 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

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

enum (GradeChangeType)

Rodzaj zmiany oceny w tym momencie w historii ocen za przesłane zadanie.

GradeChangeType

Możliwe typy zmian ocen.

Wartości w polu enum
UNKNOWN_GRADE_CHANGE_TYPE Nie określono typu zmiany oceny. Nie powinno to nigdy zostać zwrócone.
DRAFT_GRADE_POINTS_EARNED_CHANGE zmiana licznika oceny w wersji roboczej;
ASSIGNED_GRADE_POINTS_EARNED_CHANGE zmiana licznika przypisanej oceny;
MAX_POINTS_CHANGE Zmiana mianownika oceny.

Metody

get

 Zwraca przesłane przez ucznia zadanie.

list

 Zwraca listę zadań odesłanych przez uczniów, które osoba wysyłająca żądanie może wyświetlić, z uwzględnieniem zakresów OAuth żądania.

modifyAttachments

 Modyfikuje załączniki przesłane przez ucznia.

patch

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

reclaim

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

return

 Zwraca przesłane przez ucznia zadanie.

turnIn

 oddaje zadanie przesłane przez ucznia;