Ö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 aşağıdakilere 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ı
- Bir öğretmenin 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 Jupyter not defteri, tüm testleri aynı anda çalıştırmanızı sağlar. 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 işaretçileri 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 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 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 atama başlığı uzunluğu dahil edilirse API çağrısı hata döndürmemelidir. Test, 100'den fazla karakterden oluşan bir ödev başlığı içerir. |
| Sonuç: Düzenle | Fazladan krediyi temsil etmek için score, resultValueMax değerinden daha büyük bir değere ayarlanabilir. |
| Sonuç: Silme | DELETE /results/{result_sourced_id} uç noktası gerekli. |
| 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çiler |
|---|---|
| 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 test türünü belirtin. |
| DeleteLineItem (İsteğe bağlı / Temizle) | 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önemdeki 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önderin.