Apakah pengguna Anda menggunakan Classroom dengan Google Meet? Lihat panduan memulai Apps Script yang membahas cara memeriksa kehadiran siswa di kursus Google Meet.

Ringkasan

Classroom API menyediakan antarmuka RESTful bagi Anda untuk mengelola kursus dan daftar peserta di Google Classroom. Selain itu, tombol berbagi Classroom memungkinkan developer dan pemilik konten mengaktifkan berbagi konten mereka ke Classroom.

Siapa yang dapat menggunakan API?

Administrator domain G Suite for Education dapat menggunakan API untuk menyediakan kursus secara terprogram atas nama pengajar, menyinkronkan sistem informasi siswa dengan Classroom, dan mendapatkan visibilitas dasar ke kelas yang diajarkan di domain mereka.

Developer aplikasi dapat menggunakan Classroom API untuk mengintegrasikan aplikasinya dengan Classroom. Aplikasi ini harus menggunakan OAuth 2.0 untuk meminta izin melihat kelas dan daftar nama siswa dari pengajar. Admin dapat membatasi apakah pengajar dan siswa di domain dapat memberi otorisasi pada aplikasi untuk mengakses data Google Classroom mereka.

Pemilik situs dan developer konten dapat menggunakan tombol berbagi Classroom untuk memungkinkan siswa dan pengajar berbagi konten kembali ke Classroom.

Semua integrasi tombol berbagi API dan Classroom harus mengikuti pedoman merek Classroom.

Ringkasan API

Classroom API terdiri dari beberapa jenis entitas yang sesuai dengan kelas, pengajar, dan siswa di antarmuka Classroom. Beberapa entitas ini memiliki properti tambahan khusus untuk API selain yang ada di Classroom. Jenis entitas utama adalah:

Untuk informasi mendetail tentang metode dan resource API, lihat referensi Classroom API.

Metadata dan alias kursus

Kursus mewakili class, seperti "M. Matematika periode ke-4 milik Smith, dan pengajar, daftar siswa, serta metadatanya milik Smith. Setiap kursus diidentifikasi oleh ID unik yang ditetapkan oleh server. Resource Kursus secara khusus merangkum semua metadata tentang kursus, seperti nama, deskripsi, lokasi, dan waktu. Daftar nama kursus dikelola melalui referensi Siswa, Pengajar, dan Undangan serta metodenya.

Alias adalah ID alternatif untuk class yang mungkin dikaitkan dengan kursus dan digunakan sebagai pengganti ID unik. Setiap alias ada di namespace yang membatasi siapa yang dapat membuat dan melihatnya. Dua namespace didukung:

  • Domain: Namespace domain berguna untuk membuat alias yang dapat diakses oleh semua pengguna, tetapi tidak spesifik untuk satu program. Misalnya, listingan alternatif untuk kursus, seperti MATH 127 dan COMSCI 127, harus dibuat di namespace domain. Alias di namespace domain hanya dapat dibuat oleh administrator domain, tetapi dapat dilihat oleh semua pengguna di domain.
  • Project developer: Namespace project developer berguna untuk mengelola alias khusus aplikasi. Misalnya, aplikasi yang menggunakan ID alternatif untuk kursus dapat membuat alias untuk memetakan ID ke kursus Classroom. Alias yang dibuat dalam namespace ini terikat dengan Konsol Google API tertentu. Setiap pengguna aplikasi dapat membuat dan melihat alias di ruang nama untuk project developer aplikasi tersebut.

Untuk informasi selengkapnya tentang cara mengelola metadata dan alias kursus, lihat Mengelola Kursus.

Pengguna dan daftar nama kursus

Siswa dan Pengajar adalah pemetaan khusus antara profil pengguna dan mata pelajaran, yang mewakili peran pengguna dalam mata pelajaran. Penetapan siswa dan pengajar tidak global: pengguna dapat ditugaskan sebagai pengajar untuk satu kursus dan siswa untuk siswa lainnya. Penetapan "siswa" atau "pengajar" mewakili serangkaian izin untuk pengguna tertentu dalam mata pelajaran tertentu.

Siswa
Resource Siswa mewakili pengguna yang terdaftar sebagai siswa dalam kursus tertentu. Siswa diizinkan untuk melihat detail dan pengajar kursus untuk kursus tersebut.
Guru
Referensi Pengajar merepresentasikan pengguna yang mengajar mata pelajaran tertentu. Pengajar diizinkan untuk melihat dan mengubah detail kursus, melihat pengajar dan siswa, serta mengelola pengajar dan siswa tambahan.

Undangan dan metode terkait menyediakan cara yang mudah untuk menambahkan siswa dan pengajar ke kursus. Dengan membuat undangan, pengguna dapat memilih untuk bergabung ke kursus atau tidak, daripada menambahkan mereka secara langsung melalui referensi pengajar dan siswa.

UserProfiles mewakili pemetaan ke profil domain pengguna seperti yang diidentifikasi oleh ID unik atau alamat email pengguna yang ditampilkan oleh Google Admin SDK. Pengguna saat ini juga dapat merujuk ke ID-nya sendiri menggunakan singkatan "me".

Untuk informasi selengkapnya tentang mengelola daftar nama siswa, lihat Mengelola Pengajar dan Siswa.

Tugas kelas dan kiriman siswa

Item CourseWork merepresentasikan satu tugas yang ditetapkan ke sekelompok siswa dalam sebuah kursus. File tersebut berisi detail seperti deskripsi, batas waktu, dan materi serta metadata seperti waktu pembuatan. Materi mencakup judul, thumbnail, dan URL, serta ID yang dapat digunakan dengan API yang sesuai (misalnya, Drive, YouTube).

Item CourseWork menjelaskan salah satu jenis tugas berikut:

  • Tugas yang diselesaikan siswa dengan mengirimkan lembar kerja atau lampiran lainnya.
  • Pertanyaan jawaban singkat atau pertanyaan pilihan ganda.

Tugas siswa untuk item CourseWork diwakili oleh StudentSubmission. Class ini terdiri dari respons dan metadata tambahan seperti status dan nilai yang ditetapkan.

Konten StudentSubmission bergantung pada jenis item CourseWork yang sesuai:

  • Lembar kerja dan lampiran yang dikirimkan untuk tugas, termasuk judul, thumbnail, dan URL-nya, serta ID yang dapat digunakan dengan API yang sesuai seperti Drive atau YouTube.
  • Respons terhadap pertanyaan jawaban singkat atau pertanyaan pilihan ganda.

Untuk informasi selengkapnya tentang cara mengelola tugas kelas dan kiriman siswa, lihat Mengelola Tugas Kelas.

Mulai

Untuk menyiapkan lingkungan dan langsung menggunakan API, coba salah satu panduan memulai:

Anda juga dapat menjelajahi referensi API.