Öğrenci Bilgi Sistemleri için OneRoster

Google Classroom, OneRoster uyumlu bir dizi öğrenci bilgi sistemi (ÖBS) için not defteri senkronizasyonunu ve öğrenci listesi içe aktarma özelliğini destekler. Google, Google tarafından belirtilen OneRoster koşullarını karşılayan ÖBS platformlarıyla iş ortaklığı yapar.

Classroom ile iş ortaklığı, yöneticilere Classroom sınıflarını ÖBS'nize bağlama olanağı sunar.

1.şekil Öğrenci bilgi sistemleri (ÖBS) Classroom ile iş ortaklığı yaptığında yöneticiler, açılır listeden ÖBS'yi seçebilir.

ÖBS iş ortağı geliştirme yolculuğu

Classroom ile iş ortaklığı yapmak istiyorsanız talep formunu doldurun.

Classroom Ekibi, ilgilenen ÖBS iş ortaklarının Google'ın şartlarını öğrenmesi için bir dizi uygunluk testi oluşturdu. Ürününüzün Google'ın şartlarını ne kadar karşıladığını belirlemek için Classroom Ekibi ile iletişime geçmeden önce uygunluk testlerini çalıştırma seçeneğiniz vardır.

Geliştirici demo alanı edinme

Entegrasyon oluşturup doğrulamak için canlı bir Google Classroom örneğine erişmek isteyebilirsiniz. Uygun test kullanıcılarının Google Workspace for Education Plus sürümünü kullanması gerekir. Bu lisanslara sahip bir Google Workspace for Education alanına yönetici erişiminiz yoksa geliştirici test alanı edinme ve demo alanı yükseltme isteğinde bulunma adımlarını tamamlayın. Alanınızda 10 Google Workspace for Education Plus lisansı sağlanı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 kullanılan jeton URL'si
  • /ims/oneroster/v1p1 ile biten OneRoster URL'si
  • Müşteri Kimliği
  • İstemci gizli anahtarı
  • Öğretmen e-posta adresi

Testleri Google Colab veya Jupyter not defterini 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ı oluşturabilirsiniz.

ÖBS gereksinimleri ve beklenen davranış

Google tarafından tanımlanan testler, ilgilenen ÖBS iş ortaklarına ürünlerinin Google'ın OneRoster tüketim koşulları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 olanağı sunmak için yapılır. Testlerle ilgili aşağıdaki noktaları okuyun. GitHub'da her testin, işaretçilerde referans verilen bir başlığı vardır. İpuçlarının soruları netleştirmeye yardımcı olabileceğini ancak testlerin kapsamlı bir listesi olmadığını unutmayın. 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: GetAllTeachers with email filter 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 için testlerin Kimlik Bilgileri bölümünde sağladığınız öğretmen e-posta adresi kullanılır.
Sınıflar: 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. Yanıt, öğrencinin e-posta adresini içermelidir.
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ı çağrılarak dönemdeki notlandırma dönemlerini almak için kullanılır.
LineItem: Create PUT /lineItems/{line_item_sourced_id} aranırken notlandırma dönemleri gerekli değildir.
LineItem: Edit Uzun bir ödev başlığı uzunluğu eklenirse API çağrısı hata döndürmemelidir. Test, 100'den fazla karakter içeren bir ödev başlığı uzunluğu içeriyor.
Sonuç: Düzenle Ek kredi için score, resultValueMax değerinden büyük bir değere ayarlanabilmelidir.
Sonuç: Sil 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. 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 Google Classroom Ekibi ile paylaşmak için indirin veya ekran görüntüsünü alın.

Destek alın

Sorularınız için classroom-sis-external@google.com adresine e-posta gönderin.