REST Resource: courses.courseWork.studentSubmissions

Zasób: StudentSubmission

Przesłanie przez ucznia pracy na potrzeby zajęć.

Elementy StudentSubmission są generowane podczas tworzenia elementu CourseWork.

Przesłane przez uczniów treści, do których nigdy nie uzyskano dostępu (czyli z state = NOWE), mogą nie mieć czasu utworzenia ani 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 kursu.

Tylko do odczytu.

courseWorkId

string

Identyfikator części zadania.

Tylko do odczytu.

id

string

Identyfikator przypisany przez Classroom do przesłania ucznia. Musi być niepowtarzalna wśród przesłanych treści dotyczących 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 tej przesyłki. Ta opcja może być wyłączona, jeśli uczeń nie uzyskał dostępu do tego elementu.

Tylko do odczytu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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

Tylko do odczytu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

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 niebędące liczbami całkowitymi), ale są one zaokrąglane do 2 miejsc po przecinku.

Są one widoczne tylko dla nauczycieli i mogą być modyfikowane tylko przez nich.

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 niebędące liczbami całkowitymi), ale są one zaokrąglane do 2 miejsc po przecinku.

Tylko nauczyciele mogą modyfikować te ustawienia.

rubricId

string

Tylko dane wyjściowe. Identyfikator oceny cząstkowej obecnie dołączonej do tego projektu i używanej do oceniania przesłanych przez ucznia treści.

Jeśli nie ma kryteriów, identyfikator jest pusty. Ten identyfikator odzwierciedla aktualnie aktywną skalę ocen; zmienia się, jeśli nauczyciele usuwają i tworzą ponownie skalę.

Tylko do odczytu.

draftRubricGrades

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

Oceny cząstkowe oczekujące na ocenę na podstawie kryteriów kryteriów.

Ta mapa jest pusta, jeśli do pracy domowej nie jest dołączona karta ocen lub jeśli dołączona jest karta, ale nie ustawiono ocen dla żadnych kryteriów. Wpisy są wypełniane tylko w przypadku ustawionych ocen. Klucz: identyfikator kryterium kryteriów.

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 kryteriów.

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

Tylko do odczytu.

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

courseWorkType

enum (CourseWorkType)

Typ zadania, do którego odnosi się przesyłany materiał.

Tylko do odczytu.

associatedWithDeveloper

boolean

Określa, czy przesłane przez studenta zgłoszenie jest powiązane z projektem w Konsoli programistów, który przesłał żądanie.

Więcej informacji znajdziesz w artykule courseWork.create.

Tylko do odczytu.

submissionHistory[]

object (SubmissionHistory)

historia przesłania (w tym historia stanu i ocen);

Tylko do odczytu.

previewVersion

enum (PreviewVersion)

Tylko dane wyjściowe. Wersja wstępna interfejsu API. Aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach programu w wersji podglądowej, musisz ustawić tę opcję.

Pole unii content. Treść przesłanego materiału. Konkretny typ zależy od wartości course_work_type. content może być tylko jednym z tych elementów:
assignmentSubmission

object (AssignmentSubmission)

Treść przesłania, gdy typ pracy zaliczeniowej to ASSIGNMENT (Projekt).

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

shortAnswerSubmission

object (ShortAnswerSubmission)

Treść przesłania, gdy typ pracy zaliczeniowej to SHORT_ANSWER_QUESTION.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

Treść przesyłana, gdy typ pracy zaliczeniowej to MULTIPLE_CHOICE_QUESTION.

RubricGrade

Ocena według kryteriów za projekt ucznia. Na każde kryterium oceny cząstkowej można podać maksymalnie 1 wartość.

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ć punktów. Jeśli nie jest ustawiony, oznacza to, że nie ustawiono punktów dla tego kryterium.

AssignmentSubmission

zadanie ucznia w projekcie,

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

object (Attachment)

Załączniki dodane przez ucznia. Pliki na Dysku odpowiadające 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, który wysłał żądanie, ma do nich dostęp. Pola identyfikator i alternatywnaUsługa są zawsze dostępne, ale inne (np. tytuł) mogą być niedostępne.

Załącznik

Załącznik dodany do projektu ucznia.

Podczas tworzenia załączników nie można ustawić 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 unii attachment. Dane załącznika. attachment może być tylko jednym z tych elementów:
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 nad pytaniem z krótką odpowiedzią.

Zapis JSON
{
  "answer": string
}
Pola
answer

string

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

MultipleChoiceSubmission

Zadania uczniów dotyczące pytania jednokrotnego wyboru.

Zapis JSON
{
  "answer": string
}
Pola
answer

string

Wybór ucznia.

SubmissionHistory

historia przesłanych danych. Obejmuje to obecnie historię stanu 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 być StateHistory lub GradeHistory. type może być tylko jednym z tych elementów:
stateHistory

object (StateHistory)

informacje o historii stanu przesyłanych danych (jeśli są dostępne).

gradeHistory

object (GradeHistory)

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

StateHistory

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

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

enum (State)

Etap przepływu pracy w ramach przepływu pracy.

stateTimestamp

string (Timestamp format)

Data, kiedy zgłoszenie osiągnęło ten stan.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

actorUserId

string

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

Stan

Możliwe stany przesyłania.

Wartości w polu enum
STATE_UNSPECIFIED Nie podano stanu. Ten parametr nigdy nie powinien być zwracany.
CREATED Plik został utworzony.
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 wybrał opcję „wycofaj projekt”, dzięki czemu ponownie uzyskał kontrolę nad projektem jako jego właściciel.
STUDENT_EDITED_AFTER_TURN_IN Uczeń edytował przesłany projekt po jego oddaniu. Obecnie jest używany tylko w przypadku pytań, gdy uczeń edytuje swoją odpowiedź.

GradeHistory

Historia wszystkich ocen dotyczących tego zgłoszenia.

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

number

Licznik oceny w danym momencie w historii ocen przesłań.

maxPoints

number

Mianownik oceny w historii ocen przesyłania w danym momencie.

gradeTimestamp

string (Timestamp format)

Kiedy zmieniono ocenę przesłanego projektu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

actorUserId

string

Nauczyciel, który wprowadził zmianę oceny.

gradeChangeType

enum (GradeChangeType)

Typ zmiany oceny w historii ocen w przesyłaniu.

GradeChangeType

Możliwe typy zmian ocen

Wartości w polu enum
UNKNOWN_GRADE_CHANGE_TYPE Nie określono typu zmiany oceny. Ten parametr nigdy nie powinien być zwracany.
DRAFT_GRADE_POINTS_EARNED_CHANGE zmiana mianownika oceny wersji roboczej.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE zmiana mianownika przypisanej oceny.
MAX_POINTS_CHANGE zmiana mianownika oceny;

Metody

get

Zwraca projekt przesłany przez ucznia.

list

Zwraca listę prac uczniów, które można wyświetlić, uwzględniając zakresy protokołu OAuth żądania.

modifyAttachments

Modyfikuje załączniki przesłane przez ucznia.

patch

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

reclaim

odzyskać przesłane przez ucznia treści w imieniu ucznia, który jest ich właścicielem;

return

Zwraca projekt przesłany przez ucznia.

turnIn

oddaje projekt ucznia.