Method: courses.courseWork.patch

Aktualizuje jedno lub więcej pól zadania.

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

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.
  • FAILED_PRECONDITION, jeśli żądane zadanie w kursie zostało już usunięte.
  • NOT_FOUND, jeśli żądany kurs, zadanie lub zadanie nie istnieje.

Żą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 wskazująca, które pola na zajęciach mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Aktualizacja nie powiedzie się, 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 pole, które nie obsługuje pustych wartości, zostanie uwzględnione w masce aktualizacji, a nie ustawione w obiekcie CourseWork, zostanie zwrócony błąd INVALID_ARGUMENT.

Nauczyciele mogą określić te pola:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId

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

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