Method: courses.courseWork.patch

Aktualizuje co najmniej 1 pole zadania.

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

To żądanie musi zostać wysłane przez projekt w Konsoli dewelopera identyfikatora klienta OAuth użytego do utworzenia odpowiedniego elementu zadania.

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

  • PERMISSION_DENIED jeśli projekt dewelopera wysyłającego żądanie nie utworzył odpowiedniego zadania, jeśli użytkownik nie ma uprawnień do wprowadzania żądanych zmian w przesłanej przez ucznia pracy lub jeśli wystąpiły błędy dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest błędnie sformatowane.
  • FAILED_PRECONDITION, jeśli żądane zadanie zostało już usunięte.
  • NOT_FOUND, jeśli żądane zajęcia lub zadanie nie istnieją.

Żą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 przez Classroom lub alias.
id

string

Identyfikator zadania.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska, która określa, które pola zadania mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Jeśli zostaną podane nieprawidłowe pola, aktualizacja się nie powiedzie. Jeśli pole obsługuje puste wartości, można je wyczyścić, określając je w masce aktualizacji, ale nie w obiekcie CourseWork. Jeśli pole, które nie obsługuje pustych wartości, jest uwzględnione w masce aktualizacji i 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
  • learningGoals

Jest to rozdzielana 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 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 Autoryzacja.