Öğ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 ş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 talep formunu doldurun.

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.

Geliştirici demo alanı edinme

Entegrasyon oluşturmak ve doğrulamak için canlı bir Google Classroom örneğine erişmeniz gerekebilir. Uygun test kullanıcılarının Google Workspace for Education Plus sürümüne sahip olması 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ıza 10 Google Workspace for Education Plus lisansı sağlanır.

Testlere erişme ve testleri çalıştırma

Testleri çalıştırmak için şunları yapmanız gerekir:

  • OAuth 2.0 kimlik bilgilerini almak için jeton URL'si
  • /ims/oneroster/v1p1 ile biten bir OneRoster URL'si
  • Müşteri 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 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önem içindeki 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 score, ek krediyi temsil etmek için resultValueMax'tan büyük bir değere ayarlanabilir.
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 için classroom-sis-external@google.com adresine e-posta gönderebilirsiniz.