Method: courses.courseWork.patch

Aktualizuje co najmniej jedno pole zadania.

Szczegółowe informacje o tym, które pola można aktualizować i kto może wprowadzać, znajdziesz na stronie google.classroom.v1.CourseWork.

To żądanie musi zostać wysłane przez projekt w Konsoli programisty o identyfikatorze klienta OAuth użytym do utworzenia odpowiedniego elementu roboczego szkolenia.

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

  • PERMISSION_DENIED, jeśli projekt dewelopera nie utworzył odpowiednich zadań, użytkownik nie ma uprawnień do wprowadzenia żądanej zmiany w przesłanym przez ucznia lub błędach dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest uszkodzone.
  • FAILED_PRECONDITION, jeśli żądane zadanie zostało już usunięte.
  • NOT_FOUND, jeśli nie istnieje żądany kurs lub zadanie.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

Identyfikator zajęć. Może to być identyfikator przypisany do Classroom lub alias.

id

string

Identyfikator zadania na zajęciach.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska określająca, które pola na kursie mają być aktualizowane. To pole jest wymagane do aktualizacji. Aktualizacja się nie uda, jeśli podasz nieprawidłowe pola. Jeśli pole obsługuje puste wartości, można je wyczyścić, określając je w masce aktualizacji, a nie w obiekcie CourseWork. Jeśli maska aktualizacji zawiera pole, które nie obsługuje pustych wartości, ale nie jest ustawione w obiekcie CourseWork, zwracany jest błąd INVALID_ARGUMENT.

Nauczyciele mogą określić te pola:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId Dostępne w wersji V1_20240401_PREVIEW i nowszych.

Jest to rozdzielana przecinkami lista w pełni kwalifikowanych nazw pól. Przykład: "user.displayName,photo".

previewVersion

enum (PreviewVersion)

Opcjonalnie. Wersja testowa interfejsu API. Jest ono wymagane, aby można było korzystać z nowych funkcji interfejsu API udostępnianych deweloperom w programie testowania wersji przedpremierowej.

Treść żądania

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

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.