Google Classroom mendukung sinkronisasi buku nilai dan impor daftar nama siswa untuk sejumlah Sistem Informasi Siswa (SIS) yang mematuhi OneRoster. Google bermitra dengan platform SIS yang memenuhi persyaratan OneRoster yang ditentukan Google.
Dengan bermitra dengan Classroom, administrator dapat menghubungkan kelas Classroom mereka dengan SIS Anda.
Gambar 1. Saat Sistem Informasi Siswa (SIS) bermitra dengan Classroom, administrator dapat memilih SIS di menu drop-down.
Perjalanan pengembangan partner SIS
Jika Anda tertarik untuk bermitra dengan Classroom, isi formulir minat.
Tim Classroom telah membuat serangkaian pengujian kesesuaian yang dapat digunakan oleh partner SIS yang tertarik untuk memahami persyaratan Google. Anda memiliki opsi untuk menjalankan pengujian kesesuaian sebelum menghubungi tim Classroom untuk menentukan seberapa dekat produk Anda memenuhi persyaratan Google.
Mendapatkan domain demo developer
Anda mungkin memerlukan akses ke instance Google Classroom aktif untuk membuat dan memvalidasi integrasi. Pengguna pengujian yang memenuhi syarat memerlukan Google Workspace for Education edisi Plus. Jika Anda tidak memiliki administrator akses ke domain Google Workspace for Education dengan lisensi ini, selesaikan langkah-langkah untuk mendapatkan domain pengujian developer dan meminta upgrade domain demo. Domain Anda akan disediakan dengan 10 lisensi Google Workspace for Education Plus.
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 - ID Klien
- Rahasia klien
- Alamat email guru
Anda dapat menjalankan pengujian menggunakan Google Colab atau notebook Jupyter. Colab dan notebook Jupyter memungkinkan Anda menjalankan semua pengujian sekaligus. Hal ini membantu Anda membuat hasil pengujian untuk dibagikan kepada tim Google Classroom.
Persyaratan dan perilaku yang diharapkan dari SIS
Pengujian yang ditentukan Google ada untuk memberi partner SIS yang tertarik cara menentukan apakah produk mereka memenuhi persyaratan penggunaan OneRoster Google dan untuk meminimalkan error yang mungkin dialami pengguna saat menggunakan integrasi SIS di Classroom. Baca pointer berikut tentang pengujian. Di GitHub, setiap pengujian memiliki judul yang dirujuk dalam pointer. Perlu diingat bahwa pointer dapat membantu mengklarifikasi pertanyaan, tetapi bukan daftar pengujian yang komprehensif. Pastikan Anda telah menjalankan semua pengujian yang disediakan di GitHub.
| Pengujian | Pointer |
|---|---|
| Guru: 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. |
| Guru: GetAllTeachers dengan filter email | Endpoint GET /teachers dipanggil dengan parameter kueri filter yang digunakan untuk memfilter berdasarkan alamat email guru. Tindakan ini akan menggunakan alamat email guru yang Anda berikan di bagian Kredensial pengujian. |
| Kelas: 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. Ini term_sourced_id 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 100+ karakter. |
| Result: Edit | Anda harus dapat menetapkan score ke nilai yang lebih besar dari resultValueMax untuk mewakili kredit tambahan. |
| Result: Delete | Endpoint DELETE /results/{result_sourced_id} diperlukan. |
| LineItem (Opsional / Pembersihan): Delete dan Get | Endpoint DELETE /lineItems/{line_item_sourced_id} tidak diperlukan. Endpoint ini bersifat opsional dan digunakan untuk pembersihan data. Endpoint GET /classes/{class_sourced_id}/lineItems berikutnya juga bersifat opsional, dan menguji apakah item baris telah dihapus. |
Membagikan hasil pengujian kepada tim Google Classroom
Setelah Anda menjalankan pengujian, laporan lengkap dengan hasil setiap pengujian akan dibuat. Pengujian ini digunakan untuk menentukan apakah produk Anda memenuhi persyaratan penggunaan OneRoster 1.2 Google. Download atau ambil screenshot laporan yang dibuat untuk dibagikan kepada kontak Anda di tim Google Classroom.