SIS を Classroom と統合するには、提供された適合性テストのセットを実行して、プロダクトが Classroom のパートナーシップ要件を満たしていることを確認します。
テストにアクセスして実行する
コンフォーマンス テストには GitHub からアクセスできます。テストを実行するには、次のものが必要です。
- OAuth 2.0 認証情報を取得するトークン URL
/ims/oneroster/v1p1で終わる One Roster URL- クライアント ID
- クライアント シークレット
- 教師のメールアドレス
テストスイートには 3 つのセクションがあります。
- 基本的な成績の同期
- 成績のカテゴリ
- 採点期間
テストは、Google Colab または Jupyter ノートブックを使用して実行できます。Colab と Jupyter ノートブックの両方で、すべてのテストを一度に実行できます。これにより、テスト結果を生成して Google Classroom チームと共有できます。
SIS の要件と想定される動作
Google が定義したテストは、一貫性を維持し、Classroom と SIS の統合を利用しているときに生徒が遭遇する可能性のあるエラーを最小限に抑えるために存在します。テストに関する以下のポイントを確認してください。GitHub では、各テストにポインタで参照されるタイトルがあります。これらのヒントは質問を明確にするのに役立ちますが、テストの包括的なリストではありません。GitHub で提供されているテストがすべて実行されていることを確認します。
基本的な成績の同期
| テスト | ポインタ |
|---|---|
| 教師: GetAllTeachers | GET /teachers エンドポイントは、limit クエリ パラメータで呼び出されます。後続のテストでは、このパラメータを使用して、プロダクトが 10,000 のページサイズをサポートできることを確認します。 |
| 教師: メールフィルタを使用した GetAllTeachers | GET /teachers エンドポイントは、教師のメールアドレスに基づいてフィルタリングするために使用される filter クエリ パラメータとともに呼び出されます。テストの [認証情報] セクションで指定した教師のメールアドレスが使用されます。 |
| クラス: GetClassesForTeacher | /teachers/{teacher_sourced_id}/classes エンドポイントは、アクティブなクラスに基づいてフィルタするために使用される filter クエリ パラメータとともに呼び出されます。 |
| 生徒: GetStudentsForClass | GET /classes/{class_sourced_id}/students エンドポイントが呼び出されます。生徒のメールアドレスがレスポンスで返される必要があります。 |
| 広告申込情報: 作成 | PUT /lineItems/{line_item_sourced_id} を呼び出すときに、採点カテゴリや採点期間は必要ありません。 |
| LineItem: 編集 | 長い課題のタイトルが含まれていても、API 呼び出しでエラーが返されないようにする必要があります。テストに、100 文字を超える長さの課題のタイトルが含まれている。 |
| 結果: 編集 | score を resultValueMax より大きい値に設定して、追加のクレジットを表すことができます。 |
| 結果: 削除 | DELETE /results/{result_sourced_id} エンドポイントは必須です。 |
| LineItem（省略可 / クリーンアップ）: 削除と取得 | DELETE /lineItems/{line_item_sourced_id} エンドポイントは必須ではありません。これはオプションで、データのクリーンアップに使用されます。後続の GET /classes/{class_sourced_id}/lineItems エンドポイントも省略可能です。このエンドポイントは、広告申込情報が削除されたことをテストします。 |
成績のカテゴリ
| テスト | ポインタ |
|---|---|
| GetAllCategories または GetCategoriesForClass | GET /categories エンドポイントは、GetAllCategories または GetCategoriesForClass のいずれか 1 つのみ必要です。すべてのテストを同時に実行する場合は、使用していないものをコメントアウトしてください。 |
| DeleteLineItem（省略可 / クリーンアップ） | DeleteLineItem テストは省略可能です。データのクリーンアップに使用できます。 |
採点期間
| テスト | ポインタ |
|---|---|
| GetGradingPeriodsForTerm | 採点期間のサポートは、フィルタ付きの GetAllClasses で term_sourced_id を取得することでテストされます。この term_sourced_id は、GetGradingPeriodsForTerm テストで GET terms/{term_sourced_id}/gradingPeriods エンドポイントを呼び出して、学期内の採点期間を取得するために使用されます。 |
テスト結果を Google Classroom チームと共有する
テストを実行すると、各テストの結果を含む完全なレポートが生成されます。これらのテストは、プロダクトが Google の OneRoster 1.1 の使用要件を満たしているかどうかを判断するために使用されます。生成されたレポートをダウンロードするか スクリーンショットを撮りますレポートと、プロダクトの OneRoster 1.1 認定資格へのリンクを classroom-sis-external@google.com にメールで送信します。
サポートを受ける
ご質問やご不明な点がございましたら、classroom-sis-external@google.com までメールでお問い合わせください。