ÖBS'nizi Classroom ile entegre etmek için sağlanan uyumluluk testlerini çalıştırarak ürününüzün Classroom'un iş ortağı koşullarını karşıladığını doğrulayın.
Testlere erişme ve testleri çalıştırma
Uygunluk testlerine GitHub'dan erişebilirsiniz. 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- İstemci Kimliği
- İstemci gizli anahtarı
- Öğretmen e-posta adresi
Test paketinde üç bölüm vardır:
- Temel Not Senkronizasyonu
- Notlandırma Kategorileri
- Notlandırma dönemleri
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, tutarlılığı korumak ve kullanıcıların Classroom ile ÖBS entegrasyonlarını kullanırken karşılaşabilecekleri hataları en aza indirmek için tasarlanmıştır. Testlerle ilgili aşağıdaki noktaları okuyun. GitHub'da her testin, işaretçilerde referans verilen bir başlığı vardır. İpuçları soruları netleştirmeye yardımcı olabilir ancak testlerin kapsamlı bir listesi değildir. GitHub'da sağlanan tüm testleri çalıştırdığınızdan emin olun.
Temel Not Senkronizasyonu
| 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. |
| Satır Öğesi: Oluştur | PUT /lineItems/{line_item_sourced_id} çağrısı yapılırken notlandırma kategorileri veya 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 silinip silinmediğini test eder. |
Notlandırma Kategorileri
| Test | İşaretçi |
|---|---|
| GetAllCategories veya GetCategoriesForClass | Yalnızca bir GET /categories uç noktası (GetAllCategories veya GetCategoriesForClass) gereklidir. Tüm testleri aynı anda çalıştırıyorsanız kullanmadığınız testin yorumunu kaldırın. |
| DeleteLineItem (İsteğe bağlı / Temizlik) | DeleteLineItem testi isteğe bağlıdır ve veri temizliği için kullanılabilir. |
Notlandırma dönemleri
| Test | İşaretçi |
|---|---|
| GetGradingPeriodsForTerm | Notlandırma dönemleri desteği, filtre testi ile GetAllClasses'ta term_sourced_id döndürülerek test edilir. Bu term_sourced_id, GetGradingPeriodsForTerm testinde 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. |
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.1 tüketim koşullarını karşılayıp karşılamadığını belirlemek için kullanılır. Oluşturulan raporu indirin veya ekran görüntüsünü alın. Raporu ve ürününüzün OneRoster 1.1 sertifikasına ait bağlantıyı classroom-sis-external@google.com adresine e-postayla gönderin.
Destek alın
Sorularınız veya endişeleriniz için classroom-sis-external@google.com adresine e-posta gönderebilirsiniz.