Google Classroom, OneRoster uyumlu birçok ÖBS için not defteri senkronizasyonunu ve öğrenci listesi içe aktarma özelliğini destekler. Google, Google tarafından belirtilen OneRoster şartlarını karşılayan ÖBS platformlarıyla iş ortaklığı yapar.
Classroom ile iş ortaklığı yapmak, yöneticilerin Classroom sınıflarını ÖBS'nize bağlamalarına olanak tanır.
Şekil 1. Öğrenci bilgi sistemleri (ÖBS) Classroom ile iş ortaklığı yaptığında yöneticiler açılır menüden ÖBS'yi seçebilir.
ÖBS iş ortağı geliştirme yolculuğu
Classroom ile iş ortaklığı yapmak istiyorsanız daha fazla bilgi edinmek için classroom-sis-external@google.com adresinden bize ulaşın.
Classroom ekibi, ilgilenen ÖBS iş ortaklarının Google'ın şartları hakkında bilgi edinmek için kullanabileceği bir dizi uyumluluk testi oluşturdu. Ürününüzün Google'ın koşullarına ne kadar uyduğunu belirlemek için Classroom ekibine ulaşmadan önce uygunluk testlerini çalıştırabilirsiniz.
Testlere erişme ve testleri çalıştırma
Testleri çalıştırmak için şunlara ihtiyacınız vardır:
- OAuth 2.0 kimlik bilgilerini almak için jeton URL'si
/ims/oneroster/v1p1ile biten bir OneRoster URL'si- Müşteri Kimliği
- İstemci gizli anahtarı
- Öğretmen e-posta adresi
Testleri Google Colab veya Jupyter not defteri kullanarak çalıştırabilirsiniz. Hem Colab hem de Jupyter not defteri, tüm testleri aynı anda çalıştırmanıza olanak tanır. Bu sayede, Google Classroom ekibiyle paylaşmak için test sonuçlarını oluşturabilirsiniz.
ÖBS şartları ve beklenen davranış
Google tarafından tanımlanan testler, ilgilenen ÖBS iş ortaklarına ürünlerinin Google'ın OneRoster tüketim şartlarını karşılayıp karşılamadığını belirleme ve kullanıcıların Classroom'da ÖBS entegrasyonlarını kullanırken karşılaşabilecekleri hataları en aza indirme olanağı sunmak için tasarlanmıştır. Testlerle ilgili aşağıdaki ipuçlarını okuyun. GitHub'da her testin, işaretçilerde referans verilen bir başlığı vardır. İpuçları soruların netleştirilmesine yardımcı olabilir ancak bu, testlerin kapsamlı bir listesi değildir. GitHub'da sağlanan tüm testleri çalıştırdığınızdan emin olun.
| Test | İşaretçi |
|---|---|
| Öğretmenler: GetAllTeachers | GET /teachers uç noktası, limit sorgu parametresi ile çağrılır. Sonraki testlerde bu parametre, ürününüzün 10.000 sayfa boyutunu destekleyebildiğinden emin olmak için kullanılır. |
| Öğretmenler: E-posta filtresiyle GetAllTeachers | GET /teachers uç noktası, öğretmen e-posta adresine göre filtrelemek için kullanılan bir filter sorgu parametresi ile çağrılır. Bu işlem için, testlerin Kimlik Bilgileri bölümünde belirttiğiniz öğretmen e-posta adresi kullanılır. |
| Sınıflar: GetClassesForTeacher | /teachers/{teacher_sourced_id}/classes uç noktası, etkin sınıflara göre filtrelemek için kullanılan bir filter sorgu parametresi ile çağrılır. |
| Öğrenciler: GetStudentsForClass | GET /classes/{class_sourced_id}/students uç noktası çağrılır. Yanıtta öğrenci e-postası döndürülmelidir. |
| GetGradingPeriodsForTerm | Notlandırma dönemleri desteği, term_sourced_id kullanılarak test edilir. Bu term_sourced_id, GET terms/{term_sourced_id}/gradingPeriods uç noktasını çağırarak dönemdeki notlandırma dönemlerini almak için kullanılır. |
| Satır Öğesi: Oluştur | PUT /lineItems/{line_item_sourced_id} işlevi çağrılırken notlandırma dönemleri gerekli değildir. |
| Satır öğesi: Düzenle | Uzun bir ödev başlığı uzunluğu eklenirse API çağrısı hata döndürmemelidir. Test, 100'den fazla karakter uzunluğunda bir ödev başlığı içeriyor. |
| Sonuç: Düzenle | Ekstra krediyi temsil etmek için score değerini resultValueMax değerinden büyük bir değere ayarlamak mümkün olmalıdır. |
| Sonuç: Sil | DELETE /results/{result_sourced_id} uç noktası gereklidir. |
| Satır Öğesi (İsteğe bağlı / Temizleme): Silme ve Alma | DELETE /lineItems/{line_item_sourced_id} uç noktası gerekli değildir. İsteğe bağlıdır ve veri temizliği için kullanılır. Sonraki GET /classes/{class_sourced_id}/lineItems uç noktası da isteğe bağlıdır ve satır öğesinin silindiğini test eder. |
Test sonuçlarını Google Classroom Ekibi ile paylaşma
Testleri çalıştırdıktan sonra her testin sonuçlarını içeren tam bir rapor oluşturulur. Bu testler, ürününüzün Google'ın OneRoster 1.2 tüketim koşullarını karşılayıp karşılamadığını belirlemek için kullanılır. Oluşturulan raporu indirin veya Google Classroom ekibiyle paylaşmak için ekran görüntüsünü alın.
Destek alın
Sorularınız veya endişeleriniz için classroom-sis-external@google.com adresine e-posta gönderebilirsiniz.