Google Classroom mendukung impor daftar nama siswa dan sinkronisasi buku nilai untuk sejumlah Sistem Informasi Siswa (SIS) yang mematuhi OneRoster. Google bermitra dengan platform SIS yang memenuhi persyaratan OneRoster yang ditentukan Google.
Gambar 1. Jika Sistem Informasi Siswa (SIS) berpartner dengan Classroom, administrator dapat memilih SIS di menu drop-down.
Perjalanan orientasi partner SIS
Berikut adalah ringkasan singkat perjalanan orientasi partner SIS:
Menyatakan minat: Jika Anda tertarik untuk berpartner dengan Classroom, isi formulir minat.
Pelajari dan jalankan pengujian kesesuaian: Untuk memahami apakah SIS Anda siap diintegrasikan dengan Classroom, Anda dapat meninjau pengujian kesesuaian untuk memahami persyaratan Google. Anda memiliki opsi untuk menjalankan pengujian kesesuaian sebelum menyatakan minat kepada tim Google Classroom untuk menentukan seberapa dekat produk Anda memenuhi persyaratan Google.
Hubungi tim Google Classroom: Tim Classroom akan menghubungi Anda setelah Anda mengirimkan formulir minat jika ada peluang untuk berpartner.
Bagikan hasil pengujian Anda & bangun integrasi menyeluruh: Setelah tim Classroom menghubungi Anda, bagikan hasil pengujian kesesuaian Anda. Tim Anda akan bekerja sama dengan Google untuk memvalidasi dan menyelesaikan integrasi.
Pengujian kesesuaian
Pengujian kesesuaian yang ditentukan Google tersedia untuk memberikan cara kepada partner SIS dalam menentukan apakah produk mereka memenuhi persyaratan konsumsi OneRoster Google dan untuk meminimalkan error yang mungkin dialami pengguna saat menggunakan integrasi SIS di Classroom. Pengujian dipublikasikan di GitHub.
Mengakses dan menjalankan pengujian
Untuk menjalankan pengujian, Anda memerlukan hal berikut:
- URL token untuk mengambil kredensial OAuth 2.0
- URL OneRoster yang diakhiri dengan
/ims/oneroster/v1p2 - Client ID
- Rahasia klien
- Alamat email pengajar
Anda dapat menjalankan pengujian menggunakan Google Colab atau notebook Jupyter. Colab dan notebook Jupyter memungkinkan Anda menjalankan semua pengujian sekaligus. Tindakan ini akan membantu Anda membuat hasil pengujian untuk dibagikan kepada tim Google Classroom.
Persyaratan dan perilaku yang diharapkan
Baca petunjuk berikut tentang pengujian. Di GitHub, setiap pengujian memiliki judul yang dirujuk dalam tabel. Petunjuk ini dapat membantu memperjelas pertanyaan, tetapi bukan daftar pengujian yang komprehensif. Pastikan Anda telah menjalankan semua pengujian yang disediakan di GitHub untuk memastikan kesesuaian.
| Uji | Pointer |
|---|---|
| Pengajar: GetAllTeachers | Endpoint GET /teachers dipanggil dengan parameter kueri limit. Dalam pengujian berikutnya, parameter ini digunakan untuk memastikan bahwa produk Anda dapat mendukung ukuran halaman 10.000. |
| Pengajar: GetAllTeachers dengan filter email | Endpoint GET /teachers dipanggil dengan parameter kueri filter yang digunakan untuk memfilter berdasarkan alamat email pengajar. Tindakan ini akan menggunakan alamat email pengajar yang Anda berikan di bagian Kredensial pengujian. |
| Classes: GetClassesForTeacher | Endpoint /teachers/{teacher_sourced_id}/classes dipanggil dengan parameter kueri filter yang digunakan untuk memfilter berdasarkan kelas aktif. |
| Siswa: GetStudentsForClass | Endpoint GET /classes/{class_sourced_id}/students dipanggil. Email siswa harus ditampilkan dalam respons. |
| GetGradingPeriodsForTerm | Dukungan periode penilaian diuji menggunakan term_sourced_id. term_sourced_id ini digunakan untuk mengambil periode penilaian dalam semester dengan memanggil endpoint GET /terms/{term_sourced_id}/gradingPeriods. |
| LineItem: Create | Periode penilaian tidak diperlukan saat memanggil PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | Panggilan API tidak boleh menampilkan error jika panjang judul tugas yang panjang disertakan. Pengujian ini mencakup panjang judul tugas yang berisi 100+ karakter. |
| Hasil: Edit | score harus dapat ditetapkan ke nilai yang lebih besar dari resultValueMax untuk mewakili kredit tambahan. |
| Hasil: Hapus | Endpoint DELETE /results/{result_sourced_id} wajib diisi. |
| LineItem (Opsional/Pembersihan): Delete dan Get | Endpoint DELETE /lineItems/{line_item_sourced_id} tidak diperlukan. Langkah ini bersifat opsional dan digunakan untuk pembersihan data. Endpoint GET /classes/{class_sourced_id}/lineItems berikutnya juga bersifat opsional, dan menguji bahwa item baris telah dihapus. |
Membagikan hasil pengujian kepada tim Google Classroom
Setelah Anda menjalankan pengujian, laporan lengkap yang berisi hasil setiap pengujian akan dibuat. Hasilnya digunakan untuk menentukan apakah produk Anda memenuhi persyaratan konsumsi OneRoster 1.2 Google. Download atau ambil screenshot laporan yang dibuat untuk dibagikan kepada kontak Anda di tim Google Classroom.
Mendapatkan domain demo developer
Setelah hasil pengujian kesesuaian Anda ditinjau oleh tim Google Classroom, domain demo developer memungkinkan Anda memvalidasi integrasi menyeluruh. Perlu diingat bahwa berhasil lulus uji kesesuaian tidak menjamin persetujuan kemitraan atau integrasi.
Domain demo developer adalah lingkungan Google Classroom pengujian yang aktif untuk membantu Anda memvalidasi bahwa integrasi berfungsi seperti yang diharapkan. Selesaikan langkah-langkah untuk mendapatkan domain demo developer dan meminta upgrade domain demo. Upgrade ini menyediakan 10 lisensi Google Workspace for Education Plus untuk domain Anda. Lisensi ini perlu ditetapkan kepada pengguna pengujian di domain developer Anda agar mereka dapat menguji fitur integrasi SIS di Classroom.
Pertanyaan umum (FAQ)
1. Model data apa yang diharapkan Classroom dari SIS?
Classroom mematuhi spesifikasi OneRoster 1.2. Jika SIS Anda menggunakan struktur data yang berbeda, Anda mungkin mengalami perilaku yang tidak terduga. Misalnya, jika sistem Anda mendukung hubungan bertingkat antara periode penilaian dan kategori penilaian, hal ini berada di luar spesifikasi OneRoster 1.2, dan Anda harus menguji integrasi secara menyeluruh untuk memastikan kompatibilitas yang tepat.
2. Nilai dan status tugas mana yang diekspor ke SIS?
Hanya nilai yang dikembalikan atau kiriman tugas yang ditandai sebagai "belum diserahkan" atau "dibebaskan" yang diekspor ke SIS. Draf nilai tidak diekspor.
3. Apa yang terjadi pada item baris di SIS jika tugas dihapus di Classroom?
Menghapus tugas di Classroom tidak akan menghapus item baris yang sesuai di SIS. Hal ini mencegah kehilangan data yang tidak disengaja dan penghapusan beruntun yang tidak diinginkan.