Method: courses.courseWorkMaterials.patch

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

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

  • PERMISSION_DENIED, jeśli w projekcie dewelopera, który wysyła żądanie, wystąpią błędy dostępu.
  • INVALID_ARGUMENT – jeśli żądanie jest błędnie sformatowane.
  • FAILED_PRECONDITION jeśli materiał do zajęć został już usunięty.
  • NOT_FOUND – jeśli żądane zajęcia lub materiały 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 szkolenia. Identyfikator może być przypisany przez Classroom lub być alias.
id

string

Identyfikator materiału do zadania.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

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

Nauczyciele mogą określić te pola:

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

enum (PreviewVersion)

Opcjonalnie. Wersja podglądowa punktu końcowego.

PREVIEW_VERSION_9001 obejmuje nowe możliwości: * Obsługiwane są aktualizacje materiałów. Aby zaktualizować materiały, użyj updateMask „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 „materiały” w masce aktualizacji, ale nie w obiekcie CourseWorkMaterial. Aktualizacje stanu PUBLISHED 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 po autoryzacji.