Method: courses.courseWork.patch

Zaktualizuje co najmniej 1 pole projektu zajęć.

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

Prośba musi zostać wysłana z projektu w Konsoli programistów, który ma identyfikator klienta OAuth użyty do utworzenia odpowiedniego elementu zajęć.

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

  • PERMISSION_DENIED jeśli projekt dewelopera, który wysłał prośbę, nie utworzył odpowiedniej pracy domowej, jeśli użytkownik nie ma uprawnień do wprowadzenia żądanej modyfikacji w przesłanej pracy ucznia lub z powodu błędów dostępu.
  • INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.
  • FAILED_PRECONDITION jeśli materiały do danego kursu zostały już usunięte.
  • NOT_FOUND, jeśli żądany kurs 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 kursu. Identyfikatorem może 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 w zadaniu mają zostać zaktualizowane. To pole jest wymagane do przeprowadzenia aktualizacji. Jeśli podasz 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, a nie w obiekcie CourseWork. Jeśli w polu, które nie obsługuje pustych wartości, a które nie jest ustawione w obiekcie CourseWork, jest zawarte w masce aktualizacji, 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 lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opcjonalnie: Wersja wstępna interfejsu API. Aby uzyskać dostęp do nowych funkcji interfejsu API udostępnionych deweloperom w ramach programu w wersji podglądowej, musisz ustawić tę opcję.

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 dotyczącym autoryzacji.