REST Resource: courses

{
  "id": string,
  "name": string,
  "section": string,
  "descriptionHeading": string,
  "description": string,
  "room": string,
  "ownerId": string,
  "creationTime": string,
  "updateTime": string,
  "enrollmentCode": string,
  "courseState": enum (CourseState),
  "alternateLink": string,
  "teacherGroupEmail": string,
  "courseGroupEmail": string,
  "teacherFolder": {
    object (DriveFolder)
  },
  "courseMaterialSets": [
    {
      object (CourseMaterialSet)
    }
  ],
  "guardiansEnabled": boolean,
  "calendarId": string,
  "gradebookSettings": {
    object (GradebookSettings)
  }
}

string

Identyfikator zajęć przypisany przez Classroom.

W przypadku creating a course możesz opcjonalnie ustawić w żądaniu ten identyfikator na wartość alias string, aby utworzyć odpowiedni alias. Element id jest nadal przypisany przez Classroom i po utworzeniu zajęć nie można go zaktualizować.

Określenie tego pola w masce aktualizacji szkolenia powoduje błąd.

string

Nazwa zajęć. Na przykład „Biologia 10 klasy”. Nazwa jest wymagana. Musi mieć od 1 do 750 znaków i prawidłowy ciąg znaków UTF-8.

string

Sekcja szkolenia. np. „Okres 2”. Jeśli to pole jest skonfigurowane, musi być prawidłowym ciągiem znaków UTF-8 i może mieć maksymalnie 2800 znaków.

string

Opcjonalny nagłówek opisu. Na przykład „Witamy w klasie 10 z biologii”. Jeśli to pole jest skonfigurowane, musi być prawidłowym ciągiem znaków UTF-8 i może mieć maksymalnie 3600 znaków.

string

Opcjonalny opis. Na przykład „Poznamy strukturę żywych stworzeń dzięki podręcznikom, wykładom gościnnym i pracom laboratoryjnym. Możesz się spodziewać! Jeśli to pole jest skonfigurowane, musi być prawidłowym ciągiem znaków UTF-8 i może mieć maksymalnie 30 tys. znaków.

string

Opcjonalna lokalizacja sali. Przykład: „301”. Jeśli to pole jest skonfigurowane, musi być prawidłowym ciągiem znaków UTF-8 i może mieć maksymalnie 650 znaków.

string

Identyfikator właściciela zajęć.

Gdy określasz to pole jako parametr obiektu create course request, jest ono wymagane. Może to być jeden z tych identyfikatorów:

• identyfikator numeryczny użytkownika
• adres e-mail użytkownika,
• literał ciągu "me", który wskazuje użytkownika wysyłającego żądanie

Należy to ustawić w żądaniu utworzenia. Administratorzy mogą też podać to pole w patch course request, aby przenieść prawo własności. W pozostałych kontekstach jest on dostępny tylko do odczytu.

string (Timestamp format)

Czas utworzenia szkolenia. Określenie tego pola w masce aktualizacji szkolenia 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: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Czas ostatniej aktualizacji tego szkolenia. Określenie tego pola w masce aktualizacji szkolenia 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: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

string

Kod rejestracji, którego należy użyć podczas dołączania do tych zajęć. Określenie tego pola w masce aktualizacji szkolenia powoduje błąd.

Tylko do odczytu.

enum (CourseState)

Stan kursu. Jeśli stan nie jest określony, domyślny to PROVISIONED.

string

Bezwzględny link do tego szkolenia w interfejsie internetowym Classroom.

Tylko do odczytu.

string

Adres e-mail grupy dyskusyjnej Google zawierającej wszystkich nauczycieli prowadzących te zajęcia. Ta grupa nie akceptuje poczty e-mail i można jej używać tylko na potrzeby uprawnień.

Tylko do odczytu.

string

Adres e-mail grupy dyskusyjnej Google zawierającej wszystkich uczestników zajęć. Ta grupa nie akceptuje poczty e-mail i można jej używać tylko na potrzeby uprawnień.

Tylko do odczytu.

object (DriveFolder)

Informacje o folderze na Dysku, który jest udostępniany wszystkim nauczycielom biorącym udział w zajęciach.

To pole zostanie ustawione tylko dla nauczycieli prowadzących zajęcia oraz administratorów domeny.

Tylko do odczytu.

object (CourseMaterialSet)

Zestawy materiałów, które pojawiają się na stronie „Informacje” tego szkolenia.

Tylko do odczytu.

boolean

Określa, czy powiadomienia dla opiekunów są włączone dla tych zajęć.

Tylko do odczytu.

string

Identyfikator kalendarza widoczny dla wszystkich uczestników zajęć, do którego Classroom dodaje wydarzenia dotyczące zadań i ogłoszeń w ramach zajęć.

Kalendarz szkolenia jest tworzony asynchronicznie, gdy kurs jest ustawiony na CourseState.ACTIVE po raz pierwszy (w momencie tworzenia lub gdy jest aktualizowany do wersji ACTIVE za pomocą interfejsu użytkownika lub interfejsu API). Identyfikator kalendarza nie zostanie uzupełniony, dopóki proces tworzenia nie zostanie ukończony.

Tylko do odczytu.

object (GradebookSettings)

ustawienia dziennika ocen, które określają, jak będzie obliczana ogólna ocena ucznia z zajęć, a także komu będzie ona widoczna.

Tylko do odczytu

{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}

string

Tytuł tego zestawu.

object (CourseMaterial)

Materiały dołączone do tego zestawu.

{

  // Union field material can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field material.
}

object (DriveFile)

Załącznik pliku z Dysku Google.

object (YouTubeVideo)

Załącznik wideo w YouTube.

object (Link)

Załączanie linków.

object (Form)

Załącznik do Formularzy Google.

{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}

enum (CalculationType)

Wskazuje, jak obliczana jest ocena ogólna.

enum (DisplaySetting)

Wskazuje, kto może zobaczyć ocenę ogólną.

object (GradeCategory)

Kategorie ocen dostępne w przypadku zadań w ramach zajęć.