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

ID untuk kursus ini yang ditetapkan oleh Classroom.

Saat creating a course, Anda dapat menetapkan ID ini ke alias string dalam permintaan untuk membuat alias yang sesuai. id masih ditetapkan oleh Classroom dan tidak dapat diperbarui setelah kursus dibuat.

Menentukan kolom ini dalam mask update kursus akan menyebabkan error.

string

Nama kursus. Misalnya, "10th Grade Biology". Nama wajib diisi. Panjangnya harus antara 1 dan 750 karakter serta string UTF-8 yang valid.

string

Bagian kursus. Misalnya, "Periode 2". Jika ditetapkan, kolom ini harus berupa string UTF-8 yang valid dan tidak lebih dari 2.800 karakter.

string

Judul opsional untuk deskripsi. Misalnya, "Selamat datang di Biologi Kelas 10". Jika ditetapkan, kolom ini harus berupa string UTF-8 yang valid dan tidak lebih dari 3.600 karakter.

string

Deskripsi opsional. Misalnya, "Kita akan mempelajari struktur makhluk hidup dari kombinasi buku teks, kuliah tamu, dan kerja lab. Semoga Anda bersemangat." Jika ditetapkan, kolom ini harus berupa string UTF-8 yang valid dan tidak lebih dari 30.000 karakter.

string

Lokasi ruang opsional. Misalnya, "301". Jika ditetapkan, kolom ini harus berupa string UTF-8 yang valid dan tidak lebih dari 650 karakter.

string

ID pemilik kursus.

Jika ditentukan sebagai parameter create course request, kolom ini wajib diisi. ID dapat berupa salah satu dari hal berikut:

• ID numerik untuk pengguna
• alamat email pengguna
• literal string "me", yang menunjukkan pengguna yang meminta

ID ini harus ditetapkan dalam permintaan pembuatan. Admin juga dapat menentukan kolom ini di patch course request untuk mentransfer kepemilikan. Dalam konteks lain, nilainya hanya-baca.

string (Timestamp format)

Waktu pembuatan kursus. Menentukan kolom ini dalam mask update kursus akan menyebabkan error.

Hanya baca.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Waktu pembaruan terbaru untuk kursus ini. Menentukan kolom ini dalam mask update kursus akan menyebabkan error.

Hanya baca.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

string

Kode pendaftaran yang akan digunakan saat bergabung ke kursus ini. Menentukan kolom ini dalam mask update kursus akan menyebabkan error.

Hanya baca.

enum (CourseState)

Status kursus. Jika tidak ditentukan, status defaultnya adalah PROVISIONED.

string

Link absolut ke kursus ini di UI web Classroom.

Hanya baca.

string

Alamat email grup Google yang berisi semua pengajar kursus. Grup ini tidak menerima email dan hanya dapat digunakan untuk izin.

Hanya baca.

string

Alamat email grup Google yang berisi semua anggota kursus. Grup ini tidak menerima email dan hanya dapat digunakan untuk izin.

Hanya baca.

object (DriveFolder)

Informasi tentang Folder Drive yang dibagikan kepada semua pengajar kursus.

Kolom ini hanya akan ditetapkan untuk pengajar mata pelajaran dan administrator domain.

Hanya baca.

object (CourseMaterialSet)

Kumpulan bahan yang muncul di bagian "{i>about<i}" halaman kursus ini.

Hanya baca.

boolean

Apakah notifikasi wali diaktifkan atau tidak untuk kursus ini.

Hanya baca.

string

ID Kalender untuk kalender yang dapat dilihat semua anggota kursus, tempat Classroom menambahkan acara untuk tugas dan pengumuman dalam kursus.

Kalender untuk kursus dibuat secara asinkron saat kursus disetel ke CourseState.ACTIVE untuk pertama kalinya (pada waktu pembuatan atau saat diupdate ke ACTIVE melalui UI atau API). ID Kalender tidak akan diisi hingga proses pembuatan selesai.

Hanya baca.

object (GradebookSettings)

Setelan buku nilai yang menentukan cara menghitung nilai keseluruhan siswa untuk mata pelajaran dan kepada siapa nilai itu akan ditampilkan.

Hanya baca

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

string

Judul untuk kumpulan ini.

object (CourseMaterial)

Materi yang dilampirkan ke kumpulan ini.

{

  // 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)

Lampiran file Google Drive.

object (YouTubeVideo)

Lampiran video YouTube.

object (Link)

Pengaitan link.

object (Form)

Lampiran Google Formulir.

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

enum (CalculationType)

Menunjukkan cara penghitungan nilai keseluruhan.

enum (DisplaySetting)

Menunjukkan siapa yang dapat melihat nilai keseluruhan.

object (GradeCategory)

Kategori nilai yang tersedia untuk tugas mata pelajaran dalam kursus ini.