Method: courses.courseWork.studentSubmissions.patch

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

Szczegółowe informacje o tym, które pola można aktualizować i kto może je zmieniać, znajdziesz w artykule google.classroom.v1.StudentSubmission.

Prośba musi zostać wysłana z projektu w Konsoli programistów, który ma identyfikator klienta OAuth użyty do utworzenia odpowiedniego elementu zajęć.

Ta metoda zwraca te kody błędów:

  • PERMISSION_DENIED jeśli projekt dewelopera, który wysłał prośbę, nie utworzył odpowiedniej pracy domowej, jeśli użytkownik nie ma uprawnień do wprowadzenia żądanej modyfikacji w przesłanej pracy ucznia lub z powodu błędów dostępu.
  • INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.
  • NOT_FOUND, jeśli żądany kurs, zadanie lub przesłane przez ucznia zadanie nie istnieją.

Żądanie HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

Identyfikator kursu. Identyfikatorem może być identyfikator przypisany przez Classroom lub alias.
courseWorkId

string

Identyfikator zadania.
id

string

Identyfikator przesłanego przez ucznia projektu.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska, która wskazuje, które pola w przesłanym przez ucznia zadaniu mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Jeśli podasz nieprawidłowe pola, aktualizacja się nie powiedzie.

Nauczyciele mogą określić te pola:

  • draftGrade
  • assignedGrade

Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opcjonalnie: 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ę.

Treść żądania

Treść żądania zawiera wystąpienie elementu StudentSubmission.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu StudentSubmission.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.