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.

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

Podanie tego pola w masce aktualizacji kursu powoduje błąd.

string

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

string

Sekcja szkolenia. Na przykład „Okres 2”. Jeśli to pole jest ustawione, musi zawierać prawidłowy ciąg znaków w formacie UTF-8 i nie może mieć więcej niż 2800 znaków.

string

Opcjonalny nagłówek opisu. Na przykład „Witamy na zajęciach z biologii dla klasy 10”. Jeśli to pole jest ustawione, musi zawierać prawidłowy ciąg UTF-8 o długości nieprzekraczającej 3600 znaków.

string

Opcjonalny opis. Na przykład: „Będziemy się uczyć o strukturze organizmów żywych na podstawie podręczników, wykładów gościnnych i pracy w laboratorium. Bądźcie podekscytowani!” Jeśli to pole jest ustawione, musi zawierać prawidłowy ciąg znaków UTF-8 i nie może mieć więcej niż 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 jest ono określone jako parametr create course request, jest wymagane. Może to być jeden z tych identyfikatorów:

• identyfikator numeryczny użytkownika
• adres e-mail użytkownika.
• ciąg znaków "me" wskazujący użytkownika, który wysłał żądanie;

Musisz go ustawić w prośbie o utworzenie. Administratorzy mogą też określić to pole w plikach patch course request, aby przenieść własność. W innych kontekstach jest ona tylko do odczytu.

string (Timestamp format)

Czas utworzenia kursu. Podanie tego pola w masce aktualizacji kursu powoduje błąd.

Tylko do odczytu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Czas ostatniej aktualizacji tego szkolenia. Podanie tego pola w masce aktualizacji kursu powoduje błąd.

Tylko do odczytu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

string

Kod rejestracji do użycia podczas rejestracji na ten kurs. 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 tych zajęć 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 adresów e-mail i może być używana tylko do przyznawania uprawnień.

Tylko do odczytu.

string

Adres e-mail grupy dyskusyjnej Google zawierającej wszystkich uczestników kursu. Ta grupa nie akceptuje adresów e-mail i może być używana tylko do przyznawania uprawnień.

Tylko do odczytu.

object (DriveFolder)

informacje o folderze na Dysku udostępnionym wszystkim nauczycielom kursu;

To pole będzie ustawione tylko dla nauczycieli kursu i administratorów domeny.

Tylko do odczytu.

object (CourseMaterialSet)

zestawy materiałów, które pojawiają się na stronie „Informacje” danego kursu.

Tylko do odczytu.

boolean

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

Tylko do odczytu.

string

Identyfikator kalendarza, który jest widoczny dla wszystkich uczestników zajęć i do którego Classroom dodaje wydarzenia związane z pracami na zajęciach oraz ogłoszenia.

Kalendarz zajęć jest tworzony asynchronicznie, gdy zajęcia po raz pierwszy zostaną ustawione jako CourseState.ACTIVE (w momencie utworzenia lub gdy zostaną zaktualizowane do ACTIVE za pomocą interfejsu lub interfejsu API). Identyfikator kalendarza nie zostanie wypeł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 z Dysku Google.

object (YouTubeVideo)

Załącznik wideo z YouTube.

object (Link)

Załącznik linku.

object (Form)

Załącznik z Formularzy Google.

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

enum (CalculationType)

Wskazuje, jak jest obliczana ocena ogólna.

enum (DisplaySetting)

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

object (GradeCategory)

Kategorie ocen dostępne dla zadań na zajęciach.