生徒情報システム向け OneRoster

Google Classroom では、OneRoster に準拠した多くの生徒情報システム（SIS）で採点簿の同期と名簿のインポートがサポートされています。Google は、Google が指定する OneRoster の要件を満たす SIS プラットフォームと提携しています。

Classroom と提携することで、管理者は Classroom のクラスを SIS に接続できるようになります。

図 1. 生徒情報システム（SIS）が Classroom と提携している場合、管理者はプルダウンで SIS を選択できます。

SIS パートナーの成長のステップ

Classroom との提携をご希望の場合は、お問い合わせフォームにご記入ください。

Classroom チームは、Google の要件を理解するために、関心のある SIS パートナーが使用できる一連の適合性テストを作成しました。適合性テストは、Classroom チームに連絡する前に実施して、Google の要件に対するプロダクトの適合度を判断することもできます。

デベロッパー デモドメインを取得する

統合を構築して検証するには、実際の Google Classroom インスタンスにアクセスする必要があります。対象となるテストユーザーには、Google Workspace for Education の Plus エディションが必要です。これらのライセンスを含む Google Workspace for Education ドメインへの管理者アクセス権がない場合は、デベロッパー テスト ドメインを取得し、デモ ドメインのアップグレードをリクエストする手順を完了します。ドメインには 10 個の Google Workspace for Education Plus ライセンスがプロビジョニングされます。

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

テストを実行するには、次のものが必要です。

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

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

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

Google が定義したテストは、関心のある SIS パートナーが、自社のプロダクトが Google の OneRoster の利用要件を満たしているかどうかを判断し、ユーザーが Classroom で SIS 統合を利用する際に発生する可能性のあるエラーを最小限に抑えるためのものです。テストに関する次のポイントをお読みください。GitHub では、各テストにポインタで参照されるタイトルがあります。なお、ポインタは質問を明確にするのに役立ちますが、テストの包括的なリストではありません。GitHub で提供されているすべてのテストを実行してください。

テスト ポインタ
教師: GetAllTeachers GET /teachers エンドポイントが limit クエリ パラメータで呼び出されます。以降のテストでは、このパラメータを使用して、製品が 10,000 のページサイズをサポートできることを確認します。
教師: メールフィルタを使用した GetAllTeachers GET /teachers エンドポイントは、教師のメールアドレスに基づいてフィルタリングするために使用される filter クエリ パラメータとともに呼び出されます。これは、テストの [Credentials] セクションで指定した教師のメールアドレスを使用します。
クラス: GetClassesForTeacher /teachers/{teacher_sourced_id}/classes エンドポイントは、アクティブなクラスに基づいてフィルタリングするために使用される filter クエリ パラメータとともに呼び出されます。
生徒: GetStudentsForClass GET /classes/{class_sourced_id}/students エンドポイントが呼び出されます。生徒のメールアドレスはレスポンスで返される必要があります。
GetGradingPeriodsForTerm 成績期間のサポートは term_sourced_id を使用してテストされます。この term_sourced_id は、GET terms/{term_sourced_id}/gradingPeriods エンドポイントを呼び出して、学期内の成績期間を取得するために使用されます。
LineItem: 作成 PUT /lineItems/{line_item_sourced_id} を呼び出すときに、成績期間は必須ではありません。
LineItem: Edit 長い課題のタイトルが含まれている場合、API 呼び出しはエラーを返しません。このテストには、課題のタイトルが 100 文字を超えるものが含まれています。
結果: 編集 score を resultValueMax より大きい値に設定して、追加のクレジットを表すことができるようにする必要があります。
結果: 削除 DELETE /results/{result_sourced_id} エンドポイントは必須です。
LineItem（省略可 / クリーンアップ）: 削除と取得 DELETE /lineItems/{line_item_sourced_id} エンドポイントは必須ではありません。これは省略可能で、データのクリーンアップに使用されます。後続の GET /classes/{class_sourced_id}/lineItems エンドポイントもオプションで、広告申込情報が削除されたことをテストします。

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

テストを実行すると、各テストの結果を含む完全なレポートが生成されます。これらのテストは、Google の OneRoster 1.2 の利用要件を満たしているかどうかを判断するために使用されます。生成されたレポートをダウンロードするか、スクリーンショットを撮って、Google Classroom チームと共有します。

サポートを受ける

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