Untuk mengintegrasikan SIS dengan Classroom, validasikan bahwa produk Anda memenuhi persyaratan kemitraan Classroom dengan menjalankan kumpulan pengujian kesesuaian yang disediakan.
Mengakses dan menjalankan pengujian
Anda dapat mengakses pengujian kepatuhan di GitHub. Untuk menjalankan pengujian, Anda memerlukan hal berikut:
- URL token untuk mengambil kredensial OAuth 2.0
- URL One Roster yang diakhiri dengan
/ims/oneroster/v1p1 - ID Klien
- Rahasia klien
- Alamat email pengajar
Ada tiga bagian dalam rangkaian pengujian:
- Sinkronisasi Nilai Dasar
- Kategori Penilaian
- Periode Penilaian
Anda dapat menjalankan pengujian menggunakan Google Colab atau notebook Jupyter. Notebook Colab dan Jupyter memungkinkan Anda menjalankan semua pengujian sekaligus. Hal ini membantu Anda membuat hasil pengujian untuk dibagikan kepada tim Google Classroom.
Persyaratan SIS dan perilaku yang diharapkan
Pengujian yang ditentukan Google ada untuk mempertahankan konsistensi dan meminimalkan error yang mungkin dialami pengguna saat menggunakan integrasi SIS dengan Classroom. Baca petunjuk berikut tentang pengujian. Di GitHub, setiap pengujian memiliki judul yang dirujuk dalam pointer. Perlu diingat bahwa pointer dapat membantu memperjelas pertanyaan, tetapi bukan daftar pengujian yang komprehensif. Pastikan Anda telah menjalankan semua pengujian yang disediakan di GitHub.
Sinkronisasi Nilai Dasar
| Tes | 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 pada pengujian. |
| Kelas: GetClassesForTeacher | Endpoint /teachers/{teacher_sourced_id}/classes dipanggil dengan parameter kueri filter yang digunakan untuk memfilter berdasarkan class aktif. |
| Siswa: GetStudentsForClass | Endpoint GET /classes/{class_sourced_id}/students dipanggil. Email siswa harus ditampilkan dalam respons. |
| LineItem: Create | Kategori penilaian atau 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 menyertakan panjang judul tugas lebih dari 100 karakter. |
| Hasil: Edit | score 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): Hapus dan Dapatkan | Endpoint DELETE /lineItems/{line_item_sourced_id} tidak diperlukan. 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. |
Kategori Penilaian
| Tes | Pointer |
|---|---|
| GetAllCategories atau GetCategoriesForClass | Hanya satu endpoint GET /categories yang diperlukan, baik GetAllCategories atau GetCategoriesForClass. Beri komentar pada pengujian yang tidak Anda gunakan jika menjalankan semua pengujian sekaligus. |
| DeleteLineItem (Opsional / Pembersihan) | Pengujian DeleteLineItem bersifat opsional dan dapat digunakan untuk pembersihan data. |
Periode Penilaian
| Tes | Pointer |
|---|---|
| GetGradingPeriodsForTerm | Dukungan periode penilaian diuji dengan mengambil term_sourced_id di GetAllClasses dengan pengujian filter. term_sourced_id ini digunakan untuk mengambil periode penilaian dalam istilah dengan memanggil endpoint GET terms/{term_sourced_id}/gradingPeriods dalam pengujian GetGradingPeriodsForTerm. |
Membagikan hasil pengujian kepada tim Google Classroom
Setelah Anda menjalankan pengujian, laporan lengkap dengan hasil setiap pengujian akan dihasilkan. Pengujian ini digunakan untuk menentukan apakah produk Anda memenuhi persyaratan penggunaan OneRoster 1.1 Google. Download atau ambil screenshot laporan yang dihasilkan. Kirim laporan dan link ke sertifikasi OneRoster 1.1 produk Anda melalui email ke classroom-sis-external@google.com.
Mendapatkan dukungan
Kirim email ke classroom-sis-external@google.com jika ada pertanyaan atau masalah.