Method: courses.courseWork.studentSubmissions.patch

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

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

To żądanie musi zostać wysłane przez projekt w Konsoli dewelopera, który jest powiązany z identyfikatorem klienta OAuth używanym do utworzenia odpowiedniego zadania lub załącznika dodatku z włączoną synchronizacją ocen w odpowiednim zadaniu.

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

  • PERMISSION_DENIED jeśli projekt dewelopera wysyłającego żądanie nie utworzył odpowiedniego zadania lub załącznika dodatku w odpowiednim zadaniu z włączoną synchronizacją ocen, jeśli użytkownik nie ma uprawnień do wprowadzenia żądanej modyfikacji w zadaniu przesłanym przez ucznia lub jeśli wystąpią błędy dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest nieprawidłowe.
  • NOT_FOUND, jeśli żądane zajęcia, zadanie lub zadanie przesłane przez ucznia 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 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, która określa, które pola w zadaniu przesłanym przez ucznia mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Jeśli zostaną podane nieprawidłowe pola, aktualizacja się nie powiedzie.

Nauczyciele mogą określić te pola:

  • draftGrade
  • assignedGrade

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

enum (PreviewVersion)

Opcjonalnie. Wersja interfejsu API w wersji zapoznawczej. Aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach Programu testowania aktualizacji, musisz ustawić tę wartość.

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.