- Zasób: Kurs
- CourseState
- CourseMaterialSet
- CourseMaterial
- GradebookSettings (Ustawienia dziennika ocen)
- CalculationType
- DisplaySetting
- Metody
Zasób: Kurs
Kurs w Classroom.
Zapis JSON |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
Pola | |
---|---|
id |
Identyfikator zajęć przypisany przez Classroom. Jeśli ustawiona jest wartość Określenie tego pola w masce aktualizacji kursu powoduje błąd. |
name |
Nazwa zajęć. Na przykład „Biologia 10 klasy”. Nazwa jest wymagana. Musi mieć od 1 do 750 znaków i prawidłowy ciąg UTF-8. |
section |
Sekcja kursu. np. „Okres 2”. Jeśli jest ustawione, pole musi zawierać prawidłowy ciąg UTF-8 o długości maksymalnie 2800 znaków. |
descriptionHeading |
Opcjonalny nagłówek opisu. Na przykład „Witamy w klasie 10”. Jeśli jest ustawione, pole musi zawierać prawidłowy ciąg UTF-8 o długości maksymalnie 3600 znaków. |
description |
Opcjonalny opis. Na przykład: „Poznamy budowę żywych istot dzięki podręcznikom, wykładom z gościnnych wykładów i pracom laboratoryjnym. Spodziewam się ekscytacji!” Jeśli jest ustawione, pole musi zawierać prawidłowy ciąg UTF-8 o długości maksymalnie 30 000 znaków. |
room |
Opcjonalna lokalizacja sali. np. „301”. Jeśli jest ustawione, pole musi zawierać prawidłowy ciąg UTF-8 o długości maksymalnie 650 znaków. |
ownerId |
Identyfikator właściciela zajęć. To pole jest wymagane, gdy określisz parametr
Musisz go ustawić w żądaniu utworzenia. Administratorzy mogą też przenieść własność za pomocą tego pola w |
creationTime |
Czas utworzenia kursu. Określenie tego pola w masce aktualizacji kursu powoduje błąd. Tylko do odczytu. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
updateTime |
Czas ostatniej aktualizacji tego kursu. Określenie tego pola w masce aktualizacji kursu powoduje błąd. Tylko do odczytu. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
enrollmentCode |
Kod rejestracji, którego należy użyć podczas dołączania do tych zajęć. Określenie tego pola w masce aktualizacji kursu powoduje błąd. Tylko do odczytu. |
courseState |
Stan kursu. Jeśli nie określono inaczej, stan domyślny to |
alternateLink |
Bezwzględny link do tego kursu w interfejsie internetowym Classroom. Tylko do odczytu. |
teacherGroupEmail |
Adres e-mail grupy dyskusyjnej Google zawierającej wszystkich nauczycieli prowadzących zajęcia. Ta grupa nie akceptuje e-maili i można jej używać tylko w przypadku uprawnień. Tylko do odczytu. |
courseGroupEmail |
Adres e-mail grupy dyskusyjnej Google zawierającej wszystkich uczestników zajęć. Ta grupa nie akceptuje e-maili i można jej używać tylko w przypadku uprawnień. Tylko do odczytu. |
teacherFolder |
Informacje o folderze na Dysku, który jest udostępniony wszystkim nauczycielom na zajęciach. To pole zostanie skonfigurowane tylko dla nauczycieli zajęć i administratorów domeny. Tylko do odczytu. |
courseMaterialSets[] |
Zestawy materiałów, które pojawiają się na stronie „Informacje” tego kursu. Tylko do odczytu. |
guardiansEnabled |
Określa, czy w przypadku tych zajęć są włączone powiadomienia dla opiekunów. Tylko do odczytu. |
calendarId |
Identyfikator kalendarza, który jest widoczny dla wszystkich uczestników zajęć, do którego Classroom dodaje wydarzenia związane z zadaniami i ogłoszeniami na zajęciach. Kalendarz jest tworzony asynchronicznie, gdy kurs zostanie po raz pierwszy ustawiony na Tylko do odczytu. |
gradebookSettings |
Ustawienia dziennika ocen, które określają, jak będzie obliczana ogólna ocena ucznia za zajęcia i komu będzie ona wyświetlana. Tylko do odczytu |
CourseState
Możliwe stany, w których może znajdować się kurs.
Wartości w polu enum | |
---|---|
COURSE_STATE_UNSPECIFIED |
Brak stanu zajęć. Żadna zwrócona wiadomość kursu będzie używać tej wartości. |
ACTIVE |
Kurs jest aktywny. |
ARCHIVED |
Kurs został zarchiwizowany. Nie można go zmodyfikować, chyba że zostanie zmieniony na inny. |
PROVISIONED |
Kurs został utworzony, ale nie został jeszcze aktywowany. Jest dostępny dla nauczyciela głównego i administratorów domeny, którzy mogą go zmodyfikować lub zmienić na stan ACTIVE lub DECLINED . Kurs można zmienić na PROVISIONED tylko wtedy, gdy ma stan DECLINED . |
DECLINED |
Zajęcia zostały utworzone, ale zostały odrzucone. Jest dostępny dla właściciela zajęć i administratorów domeny, ale nie będzie wyświetlany w interfejsie internetowym. Nie możesz zmodyfikować zajęć, chyba że zmienisz je na PROVISIONED . Kurs można zmienić na DECLINED tylko wtedy, gdy ma stan PROVISIONED . |
SUSPENDED |
Kurs został zawieszony. Nie możesz modyfikować zajęć, a tylko użytkownik wskazany przez ownerId może je wyświetlić. Kurs może zostać oznaczony jako taki, jeśli potencjalnie narusza on Warunki korzystania z usługi. |
CourseMaterialSet
Zestaw materiałów, które pojawiają się na stronie „Informacje” kursu. Mogą one obejmować program nauczania, harmonogram lub inne ogólne informacje dotyczące całego kursu.
Zapis JSON |
---|
{
"title": string,
"materials": [
{
object ( |
Pola | |
---|---|
title |
Tytuł tego zestawu. |
materials[] |
Materiały załączone do tego zestawu. |
CourseMaterial
Materiały dołączone do kursu jako część zestawu materiałów.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy material . Dane materialne. material może mieć tylko jedną z tych wartości: |
|
driveFile |
Plik załącznika z Dysku Google. |
youTubeVideo |
Załącznik wideo w YouTube. |
link |
Atatyzacja linków. |
form |
Załącznik Formularzy Google. |
GradebookSettings
Ustawienia dziennika ocen zajęć. Więcej informacji znajdziesz w artykule w Centrum pomocy.
Zapis JSON |
---|
{ "calculationType": enum ( |
Pola | |
---|---|
calculationType |
Wskazuje sposób obliczania oceny ogólnej. |
displaySetting |
Określa, kto może zobaczyć ocenę ogólną. |
gradeCategories[] |
Kategorie ocen dostępne na potrzeby zadań w ramach kursu. |
CalculationType
Możliwe metody obliczania oceny ogólnej.
Wartości w polu enum | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
Nie określono metody. Ta wartość nigdy nie jest zwracana. |
TOTAL_POINTS |
Ocena ogólna to suma ocen podzielona przez sumę punktów, niezależnie od kategorii. |
WEIGHTED_CATEGORIES |
Ocena ogólna to średnia ważona według kategorii. |
DisplaySetting
Możliwe ustawienia wyświetlania oceny ogólnej.
Wartości w polu enum | |
---|---|
DISPLAY_SETTING_UNSPECIFIED |
Nie określono ustawienia. Ta wartość nigdy nie jest zwracana. |
SHOW_OVERALL_GRADE |
Pokazuje ocenę ogólną w dzienniku ocen i profilu ucznia zarówno dla nauczycieli, jak i uczniów. |
HIDE_OVERALL_GRADE |
nie wyświetla oceny ogólnej w dzienniku ocen ani w profilu ucznia. |
SHOW_TEACHERS_ONLY |
Pokazuje ocenę ogólną nauczycielom w dzienniku ocen i profilu ucznia. są ukryte przed uczniami w ich profilach uczniów; |
Metody |
|
---|---|
|
Wskazuje, czy użytkownik może tworzyć załączniki dodatków w danym kursie. |
|
Tworzy zajęcia. |
|
Usuwa zajęcia. |
|
Zwraca kurs. |
|
Zwraca listę kursów, które może wyświetlać użytkownik wysyłający prośbę. Zwracana jest tylko lista kursów zgodnych z żądaniem. |
|
Aktualizuje jedno lub więcej pól w kursie. |
|
Aktualizuje zajęcia. |