REST Resource: courses

Resource: Course

Kursus di Classroom.

Representasi JSON 
{
  "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)
  }
}
Kolom
id

string

ID untuk kursus ini yang ditetapkan oleh Classroom.

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

Menentukan kolom ini di mask pembaruan kursus akan menyebabkan error.
name

string

Nama kursus. Misalnya, "Biologi Kelas 10". Nama wajib diisi. Harus terdiri dari 1 hingga 750 karakter dan berupa string UTF-8 yang valid.
section

string

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

string

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

string

Deskripsi opsional. Misalnya, "Kita akan mempelajari struktur makhluk hidup dari kombinasi buku teks, kuliah tamu, dan kerja lab. Bersiaplah untuk merasa senang!" Jika disetel, kolom ini harus berupa string UTF-8 yang valid dan tidak lebih dari 30.000 karakter.
room

string

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

string

ID pemilik kursus.

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

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

Parameter ini harus disetel dalam permintaan pembuatan. Admin juga dapat menentukan kolom ini dalam patch course request untuk mentransfer kepemilikan. Dalam konteks lain, kolom ini bersifat hanya baca.
creationTime

string (Timestamp format)

Waktu pembuatan kursus. Menentukan kolom ini di mask pembaruan kursus akan menyebabkan error.

Hanya baca.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

Hanya baca.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
enrollmentCode

string

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

Hanya baca.
courseState

enum (CourseState)

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

string

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

Hanya baca.
courseGroupEmail

string

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

Hanya baca.
teacherFolder

object (DriveFolder)

Informasi tentang Folder Drive yang dibagikan kepada semua pengajar kursus.

Kolom ini hanya akan ditetapkan untuk pengajar kursus dan administrator domain.

Hanya baca.
courseMaterialSets[]
(deprecated)

object (CourseMaterialSet)

Kumpulan materi yang muncul di halaman "tentang" kursus ini.

Hanya baca.
guardiansEnabled

boolean

Apakah notifikasi wali diaktifkan untuk kursus ini atau tidak.

Hanya baca.
calendarId

string

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

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

Hanya baca.
gradebookSettings

object (GradebookSettings)

Setelan buku nilai yang menentukan cara penghitungan nilai keseluruhan siswa untuk kursus dan siapa yang akan melihatnya.

Hanya baca

CourseState

Kemungkinan status kursus.

Enum
COURSE_STATE_UNSPECIFIED Tidak ada status kursus. Tidak ada pesan Kursus yang ditampilkan akan menggunakan nilai ini.
ACTIVE Kursus aktif.
ARCHIVED Kursus telah diarsipkan. Anda tidak dapat mengubahnya kecuali untuk mengubahnya ke status yang berbeda.
PROVISIONED Kursus telah dibuat, tetapi belum diaktifkan. Status ini dapat diakses oleh pengajar utama dan administrator domain, yang dapat mengubahnya atau mengubahnya ke status ACTIVE atau DECLINED. Kursus hanya dapat diubah menjadi PROVISIONED jika dalam status DECLINED.
DECLINED Kursus telah dibuat, tetapi ditolak. File ini dapat diakses oleh pemilik kursus dan administrator domain, meskipun tidak akan ditampilkan di UI web. Anda tidak dapat mengubah kursus kecuali mengubahnya ke status PROVISIONED. Kursus hanya dapat diubah menjadi DECLINED jika dalam status PROVISIONED.
SUSPENDED Kursus telah ditangguhkan. Anda tidak dapat mengubah kursus, dan hanya pengguna yang diidentifikasi oleh ownerId yang dapat melihat kursus. Kursus dapat ditempatkan dalam status ini jika berpotensi melanggar Persyaratan Layanan.

CourseMaterialSet

Kumpulan materi yang muncul di halaman "Tentang" kursus. Materi ini dapat mencakup silabus, jadwal, atau informasi latar belakang lainnya yang berkaitan dengan kursus secara keseluruhan.

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

string

Judul untuk kumpulan ini.
materials[]

object (CourseMaterial)

Materi yang dilampirkan ke set ini.

CourseMaterial

Materi yang dilampirkan ke kursus sebagai bagian dari set materi.

Representasi JSON 
{

  // 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.
}
Kolom
Kolom union material. Data materi. material hanya dapat berupa salah satu dari berikut:
driveFile

object (DriveFile)

Lampiran file Google Drive.
youTubeVideo

object (YouTubeVideo)

Lampiran video YouTube.
form

object (Form)

Lampiran Google Formulir.

GradebookSettings

Setelan buku nilai untuk kursus. Lihat artikel pusat bantuan untuk mengetahui detailnya.

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

enum (CalculationType)

Menunjukkan cara penghitungan nilai keseluruhan.
displaySetting

enum (DisplaySetting)

Menunjukkan siapa yang dapat melihat nilai keseluruhan.
gradeCategories[]

object (GradeCategory)

Kategori nilai yang tersedia untuk tugas dalam kursus.

CalculationType

Kemungkinan metode penghitungan nilai keseluruhan.

Enum
CALCULATION_TYPE_UNSPECIFIED Tidak ada metode yang ditentukan. Ini tidak pernah ditampilkan.
TOTAL_POINTS Nilai keseluruhan adalah jumlah nilai dibagi dengan jumlah total poin terlepas dari kategori.
WEIGHTED_CATEGORIES Nilai keseluruhan adalah rata-rata berbobot menurut kategori.

DisplaySetting

Kemungkinan setelan untuk menampilkan nilai keseluruhan.

Enum
DISPLAY_SETTING_UNSPECIFIED Tidak ada setelan yang ditentukan. Ini tidak pernah ditampilkan.
SHOW_OVERALL_GRADE Menampilkan nilai keseluruhan di buku nilai dan profil siswa kepada pengajar dan siswa.
HIDE_OVERALL_GRADE Tidak menampilkan nilai keseluruhan di buku nilai atau profil siswa.
SHOW_TEACHERS_ONLY Menampilkan nilai keseluruhan kepada pengajar di buku nilai dan profil siswa. Tersembunyi dari siswa di profil siswa mereka.

Metode

checkAddOnCreationEligibility
(deprecated)

 Menampilkan apakah pengguna memenuhi syarat untuk membuat lampiran add-on dalam kursus tertentu.

checkGradingPeriodsSetupEligibility
(deprecated)

 Menampilkan apakah pengguna memenuhi syarat untuk memperbarui GradingPeriodSettings dalam kursus tertentu.

create

 Membuat kursus.

delete

 Menghapus kursus.

get

 Menampilkan kursus.

getGradingPeriodSettings

 Menampilkan setelan periode penilaian dalam kursus.

list

 Menampilkan daftar kursus yang diizinkan untuk dilihat oleh pengguna yang meminta, yang dibatasi pada kursus yang cocok dengan permintaan.

patch

 Memperbarui satu atau beberapa kolom dalam kursus.

update

 Memperbarui kursus.

updateGradingPeriodSettings

 Memperbarui setelan periode penilaian mata pelajaran.