Google Classroom, OneRoster uyumlu çeşitli öğrenci bilgi sistemleri (ÖBS) için öğrenci listesi içe aktarma ve not defteri senkronizasyonunu destekler. Google, Google tarafından belirtilen OneRoster koşullarını karşılayan ÖBS platformlarıyla iş ortaklığı yapar.
Ş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ğı oryantasyon yolculuğu
Aşağıda, SIS iş ortağı oryantasyon yolculuğuna dair kısa bir genel bakış sunulmuştur:
İlgilendiğinizi bildirme: Classroom ile iş ortaklığı yapmak istiyorsanız talep formunu doldurun.
Uygunluk testlerini inceleme ve çalıştırma: ÖBS'nizin Classroom ile entegrasyona hazır olup olmadığını anlamak için uygunluk testlerini inceleyerek Google'ın şartları hakkında bilgi edinebilirsiniz. Google Classroom ekibine ilgi beyanında bulunmadan önce uygunluk testlerini çalıştırarak ürününüzün Google'ın şartlarını ne ölçüde karşıladığını belirleyebilirsiniz.
Google Classroom ekibiyle iletişime geçin: Talep formunuzu gönderdikten sonra iş ortaklığı fırsatı varsa Classroom ekibi sizinle iletişime geçecektir.
Test sonuçlarınızı paylaşma ve uçtan uca entegrasyonu oluşturma: Classroom ekibi sizinle iletişime geçtikten sonra uygunluk testi sonuçlarınızı paylaşın. Ekibiniz, entegrasyonu doğrulamak ve tamamlamak için Google ile birlikte çalışır.
Uygunluk testleri
Google tarafından tanımlanan uygunluk testleri, Ö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şabileceği hataları en aza indirme imkanı sunar. Testler GitHub'da yayınlanır.
Testlere erişme ve testleri çalıştırma
Testleri çalıştırmak için aşağıdakilere ihtiyacınız vardır:
- OAuth 2.0 kimlik bilgilerini almak için jeton URL'si
/ims/oneroster/v1p2ile biten OneRoster URL'si- İstemci Kimliği
- İstemci gizli anahtarı
- Öğretmenin e-posta adresi
Testleri Google Colab veya Jupyter not defteri kullanarak çalıştırabilirsiniz. Hem Colab hem de Jupyter not defteri, tüm testleri tek seferde çalıştırmanıza olanak tanır. Bu sayede, Google Classroom ekibiyle paylaşılacak test sonuçlarını oluşturabilirsiniz.
Şartlar ve beklenen davranış
Testlerle ilgili aşağıdaki ipuçlarını okuyun. GitHub'da her testin tabloda referans verilen bir başlığı vardır. Bu ipuçları, soruları netleştirmenize yardımcı olabilir ancak testlerin kapsamlı bir listesi değildir. Uygunluğu sağlamak için GitHub'da sağlanan tüm testleri çalıştırdığınızdan emin olun.
| Test | İşaretçiler |
|---|---|
| Öğretmenler: GetAllTeachers | GET /teachers uç noktası, limit sorgu parametresiyle ç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 filtreleme yapmak için kullanılan bir filter sorgu parametresiyle çağrılır. Bu işlem, testlerin Kimlik Bilgileri bölümünde sağladığınız öğretmen e-posta adresini kullanır. |
| Classes: GetClassesForTeacher | /teachers/{teacher_sourced_id}/classes uç noktası, etkin sınıflara göre filtreleme yapmak için kullanılan bir filter sorgu parametresiyle çağrılır. |
| Öğrenciler: GetStudentsForClass | GET /classes/{class_sourced_id}/students uç noktası çağrılır. Öğrencinin e-posta adresi yanıtta 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şturma | PUT /lineItems/{line_item_sourced_id} çağrılırken notlandırma dönemleri gerekli değildir. |
| Satır öğesi: Düzenleme | Uzun bir ödev başlığı uzunluğu dahil edilirse API çağrısı hata döndürmemelidir. Test, 100'den fazla karakter içeren bir ödev başlığı içeriyor. |
| Sonuç: Düzenle | Ek krediyi temsil etmek için score, resultValueMax değerinden daha büyük bir değere ayarlanabilmelidir. |
| Sonuç: Silme | DELETE /results/{result_sourced_id} uç noktası gereklidir. |
| LineItem (İ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 temizleme 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 ekibiyle paylaşma
Testleri çalıştırdıktan sonra her testin sonuçlarını içeren tam bir rapor oluşturulur. Sonuçlar, ürününüzün Google'ın OneRoster 1.2 tüketim şartlarını karşılayıp karşılamadığını belirlemek için kullanılır. Google Classroom ekibindeki kişilerinizle paylaşmak için oluşturulan raporu indirin veya raporun ekran görüntüsünü alın.
Geliştirici demo alanı edinme
Uygunluk testi sonuçlarınız Google Classroom ekibi tarafından incelendikten sonra, geliştirici demo alanı sayesinde uçtan uca entegrasyonunuzu doğrulayabilirsiniz. Uygunluk testlerini başarıyla geçmenin, iş ortaklığı veya entegrasyon onayı garanti etmediğini unutmayın.
Geliştirici demo alanı, entegrasyonunuzun beklediğiniz gibi çalıştığını doğrulamanıza yardımcı olan canlı, test amaçlı bir Google Classroom ortamıdır. Geliştirici demo alanı edinme ve demo alanı yükseltme isteğinde bulunma adımlarını tamamlayın. Yükseltme işlemi, alanınız için 10 Google Workspace for Education Plus lisansının temel hazırlığını yapar. Bu lisansların, geliştirici alanınızdaki test kullanıcılarına atanması gerekir. Böylece kullanıcılar, Classroom'daki ÖBS entegrasyonu özelliklerini test edebilir.
Sık sorulan sorular
1. Classroom, ÖBS'den hangi veri modelini bekler?
Classroom, OneRoster 1.2 spesifikasyonuna uygundur. ÖBS'niz farklı bir veri yapısı kullanıyorsa beklenmedik davranışlarla karşılaşabilirsiniz. Örneğin, sisteminiz notlandırma dönemleri ile not kategorileri arasında iç içe yerleştirilmiş bir ilişkiyi destekliyorsa bu durum OneRoster 1.2 spesifikasyonunun kapsamı dışındadır ve doğru uyumluluğu sağlamak için entegrasyonunuzu kapsamlı bir şekilde test etmeniz gerekir.
2. ÖBS'ye hangi notlar ve ödev durumları aktarılır?
Yalnızca öğrencilere verdiğiniz notlar veya "eksik" ya da "muaf" olarak işaretlenmiş gönderimler ÖBS'ye aktarılır. Taslak notlar dışa aktarılmaz.
3. Classroom'da bir ödev silinirse ÖBS'deki satır öğesine ne olur?
Classroom'da bir ödevi sildiğinizde ÖBS'deki ilgili satır öğesi silinmez. Bu sayede, yanlışlıkla veri kaybı ve istenmeyen basamaklı silme işlemleri önlenir.