Method: courses.courseWorkMaterials.patch

Aktualizuje co najmniej 1 pole materiału do zajęć.

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

  • PERMISSION_DENIED, jeśli projekt dewelopera wysyłającego żądanie ma błędy dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest błędnie sformatowane.
  • FAILED_PRECONDITION, jeśli żądany materiał do zajęć został już usunięty.
  • NOT_FOUND, jeśli żądane zajęcia lub materiał do zajęć nie istnieją.

Żądanie HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{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 materiału do zajęć.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Maska, która określa, które pola materiału do zajęć 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, ale nie w obiekcie materiału do zajęć. Jeśli pole, które nie obsługuje pustych wartości, jest uwzględnione w masce aktualizacji i nie jest ustawione w obiekcie materiału do zajęć, zwracany jest błąd INVALID_ARGUMENT.

Nauczyciele mogą określić te pola:

  • title
  • description
  • state
  • scheduledTime
  • topicId
  • learningGoals

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

enum (PreviewVersion)

Opcjonalnie. Wersja podglądowa punktu końcowego.

PREVIEW_VERSION_9001 obejmuje nowe funkcje: * obsługiwane są aktualizacje materiałów. Aby zaktualizować materiały, użyj maski aktualizacji „materials”. Lista materiałów podana w obiekcie CourseWorkMaterial w żądaniu całkowicie zastąpi dotychczasową listę. Pole materiałów można wyczyścić, określając „materials” w masce aktualizacji, ale nie w obiekcie CourseWorkMaterial. Aktualizacje opublikowanych CourseWorkMaterial nie są obecnie obsługiwane.

Treść żądania

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

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

Więcej informacji znajdziesz w przewodniku Autoryzacja.