REST Resource: courses.courseWork.studentSubmissions

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 (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 związanego z kursem.

Tylko do odczytu.
id

string

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

string

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

Tylko do odczytu.
creationTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" i "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 terminie.

Tylko do odczytu.
draftGrade

number

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

number

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

string

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

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 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 "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.

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 "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

Typ zadania, którego dotyczy to zgłoszenie.

Tylko do odczytu.
associatedWithDeveloper

boolean

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: courseWork.create.

Tylko do odczytu.
submissionHistory[]

object (SubmissionHistory)

historię przesłanych zadań (w tym historie stanów i ocen).

Tylko do odczytu.
previewVersion

enum (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

object (AssignmentSubmission)

Treść przesłanej pracy, gdy obiekt sessionWorkType ma wartość ASSIGNMENT.

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

object (ShortAnswerSubmission)

Treść zadania, gdy typ polakursu ma wartość SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (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

string

Opcjonalnie. Identyfikator kryterium.
levelId

string

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

number

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 (Attachment)
    }
  ]
}
Pola
attachments[]

object (Attachment)

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 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)

Plik załącznika z Dysku Google.
youTubeVideo

object (YouTubeVideo)

Załącznik wideo w YouTube.
form

object (Form)

Załącznik 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

Uczniowie pracują nad pytaniem jednokrotnego wyboru.

Zapis JSON 
{
  "answer": string
}
Pola
answer

string

Wybór ucznia.

SubmissionHistory

historię zgłoszenia. Obecnie obejmuje to historie 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 sumy type. Typ SubmissionHistory może mieć wartość StateHistory lub GradeHistory. type może mieć tylko jedną z tych wartości:
stateHistory

object (StateHistory)

Historia stanu zgłoszenia (jeśli jest dostępna).
gradeHistory

object (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 (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Pola
state

enum (State)

Etap potoku przepływu pracy.
stateTimestamp

string (Timestamp format)

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: "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 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 (GradeChangeType)
}
Pola
pointsEarned

number

Licznik oceny obecny w historii ocen przesłanych zadań.
maxPoints

number

Mianownik oceny obecny w historii ocen zadań.
gradeTimestamp

string (Timestamp format)

Data zmiany oceny za zadanie.

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

string

nauczyciela, który zmienił ocenę.
gradeChangeType

enum (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

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

 Modyfikuje załączniki przesłane przez ucznia.

patch

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

reclaim

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

return

 Zwraca zadanie przesłane przez ucznia.

turnIn

 Odda zadanie przesłane przez ucznia.