Dodatki do Google Classroom są teraz ogólnie dostępne dla programistów. Więcej informacji znajdziesz w
dokumentacji dodatków.
Method: courses.updateGradingPeriodSettings
Aktualizuje ustawienia okresu oceniania w kursie.Użytkownik, który wysyła prośbę, oraz właściciel zajęć muszą mieć możliwość modyfikowania okresów oceniania. Szczegółowe informacje znajdziesz w wymaganiach dotyczących licencjonowania.
Ta metoda zwraca te kody błędów:
PERMISSION_DENIED jeśli użytkownik nie ma uprawnień do modyfikowania ustawień okresu oceniania w kursie lub w przypadku błędów dostępu:
- UserIneligibleToUpdateGradingPeriodSettings
INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.NOT_FOUND, jeśli wybrany kurs nie istnieje.
Żądanie HTTP
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
courseId |
string
Wymagane. Identyfikator kursu.
|
Parametry zapytania
| Parametry |
updateMask |
string (FieldMask format)
Maska, która określa, które pola w GradingPeriodSettings mają zostać zaktualizowane. Lista GradingPeriodSettings gradingPeriods zostanie całkowicie zastąpiona okresami oceniania określonymi w żądaniu aktualizacji. Na przykład:
- Okresy oceny uwzględnione na liście bez identyfikatora są uważane za dodatki, a nowy identyfikator zostanie przypisany po przesłaniu prośby.
- Okresy oceniania, które są obecnie dostępne, ale nie zostały uwzględnione w prośbie, zostaną uznane za usunięte.
- Okresy oceny z dotychczasowym identyfikatorem i zmienionymi danymi są uznawane za zmiany. Niezmodyfikowane dane pozostaną bez zmian.
- Okresy oceniania z nieznanym identyfikatorem spowodują błąd.
Możesz określić te pola:
gradingPeriodsapplyToExistingCoursework 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 GradingPeriodSettings.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu GradingPeriodSettings.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/classroom.courses
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-12-05 UTC.
[null,null,["Ostatnia aktualizacja: 2024-12-05 UTC."],[[["Updates a course's grading period settings, requiring eligibility to modify them by both the requesting user and course owner."],["The request must include a field mask to specify which fields of the GradingPeriodSettings are to be updated, potentially adding, deleting, or editing grading periods."],["The API uses a PATCH request to `https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`, where `{courseId}` is replaced with the specific course identifier."],["Potential errors include `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND` based on user permissions, request validity, and course existence."],["Authorization requires the `https://www.googleapis.com/auth/classroom.courses` OAuth scope."]]],[]]
