SIS が Google Classroom の要件を満たしていることを確認する

SIS を Classroom と統合するには、提供された適合性テストセットを実行して、プロダクトが Classroom のパートナーシップ要件を満たしていることを確認します。

アクセスしてテストを実行する

適合性テストには GitHub からアクセスできます。テストを実行するには、次のものが必要です。

  • OAuth 2.0 認証情報を取得するためのトークン URL
  • 末尾が /ims/oneroster/v1p1 の 1 件の登録選手 URL
  • クライアント ID
  • クライアント シークレット
  • 教師のメールアドレス

テストスイートには次の 3 つのセクションがあります。

  • 基本成績の同期
  • 成績のカテゴリ
  • 採点期間

テストは、Google Colab または Jupyter ノートブックを使用して実行できます。Colab ノートブックと Jupyter ノートブックのどちらでも、すべてのテストを一度に実行できます。これにより、テスト結果を生成して Google Classroom チームと共有することができます。

SIS の要件と想定される動作

Google 定義のテストは、整合性を維持し、SIS と Classroom の統合を使用する際に発生する可能性のあるエラーを最小限に抑えるために存在します。テストに関する以下のポイントを確認してください。GitHub では、各テストが @title でマークされています。これらのタイトルはポインタで参照されます。

  1. [基本成績の同期] セクションについては、次の点に注意してください。

    • GetAllTeachers テストでは、GET /teachers エンドポイントは limit= クエリ パラメータで呼び出されます。以降のテストでは、このパラメータを使用して、製品がページサイズ 10,000 をサポートできるようにします。

    • GetAllTeachers with email filter テストでは、教師のメールアドレスに基づいてフィルタリングする filter= クエリ パラメータを使用して、GET /teachers エンドポイントが呼び出されます。テストを実行するときは、教師のメールアドレスを指定する必要があります。

    • GetClassesForTeacher テストでは、アクティブなクラスに基づいてフィルタリングする filter= クエリ パラメータを使用して、/teachers/{teacher_sourced_id}/classes エンドポイントが呼び出されます。

    • GetStudentsForClass テストでは、GET /classes/{class_sourced_id}/students?limit=10000 エンドポイントが呼び出されます。回答で生徒のメールアドレスを返す必要があります。

    • PutLineItem Create テストでは、PUT /lineItems/{line_item_sourced_id} を呼び出す際に成績のカテゴリまたは採点期間は必要ありません。

    • PutLineItem Edit テストで、課題のタイトルの長さが長い場合、API 呼び出しでエラーを返さないようにします。このテストでは、課題のタイトルの長さは 100 文字以上になります。

    • PutResult Edit テストでは、score に resultValueMax より大きい値を設定して、余分な貢献度を示すことができます。

    • DELETE /results/{result_sourced_id} エンドポイントは必須であり、DeleteResult テストでテストされています。

    • DELETE /lineItems/{line_item_sourced_id} エンドポイントは必要ありません。これはオプションであり、データのクリーンアップに使用されます。

  2. [成績のカテゴリ] と [採点期間] のセクションについては、次の点に注意してください。

    • GET /categories エンドポイントは 1 つだけ必要です。すべての適合性テストを一度に実行する場合は、使用していないものをコメントアウトします。
      • /categories?limit=10000
      • /classes/{class_sourced_id}/categories?limit=10000
    • 採点期間のサポートをテストするには、GetAllClasses w/ filter テストで term_sourced_id を取得します。この term_sourced_id は、GetGradingPeriodsForTerm テストで GET terms/{term_sourced_id}/gradingPeriods?limit=10000 エンドポイントを呼び出して、学期の採点期間を取得するために使用されます。

テスト結果を Google Classroom チームと共有する

テストを実行すると、各テストの結果を含む完全なレポートが生成されます。これらのテストは、プロダクトが Google の OneRoster 1.1 の使用要件を満たしているかどうかを判断するために使用されます。生成されたレポートをダウンロードするか、スクリーンショットを撮ります。レポートとプロダクトの OneRoster 1.1 認定資格へのリンクを classroom-sis-external@google.com にメールで送信してください。

サポートを利用する

ご質問やご不明な点がございましたら、classroom-sis-external@google.com までメールでお問い合わせください。