Method: courses.courseWork.studentSubmissions.patch

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

Aby dowiedzieć się, które pola można zaktualizować, i kto może je zmieniać, wejdź na google.classroom.v1.StudentSubmission.

To zgłoszenie musi przesłać projekt w Konsoli programisty z identyfikatorem klienta OAuth użytym do utworzenia odpowiedniego elementu roboczego dotyczącego kursu.

Ta metoda zwraca następujące kody błędów:

  • PERMISSION_DENIED, jeśli projekt dewelopera, z którego wysłano prośbę, nie utworzył odpowiedniego zadania w ramach zajęć, użytkownik nie ma uprawnień do wprowadzenia żądanych zmian w przesłanym pliku przez ucznia lub jeśli wystąpiło błędy dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest uszkodzone.
  • NOT_FOUND, jeśli żądany kurs, zadanie lub zadanie nie istnieje.

Żą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 zajęć. Może to być identyfikator przypisany przez Classroom lub alias.
courseWorkId

string

Identyfikator zadania.
id

string

Identyfikator zadania przesłanego przez ucznia.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska wskazująca, które pola w przesłanym pliku przez ucznia należy zaktualizować. To pole jest wymagane do przeprowadzenia aktualizacji. Aktualizacja nie powiedzie się, jeśli podasz nieprawidłowe pola.

Nauczyciele mogą określić te pola:

  • draftGrade
  • assignedGrade

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

enum (PreviewVersion)

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

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 po autoryzacji.