以下に、Classroom アドオンを開発する際の手順の概要を示します。
オンボーディング
- Google Workspace for Education の Teaching & Learning または Plus エディションの テストユーザーが必要です。これらのライセンスのいずれかを使用して Google Workspace for Education ドメインへの管理者アクセス権がない場合は、デベロッパー テスト ドメインを取得する手順を完了してから、ドメイン アップグレード リクエスト フォームを送信してください。 ドメインには、10 個の Google Workspace for Education Plus ライセンスがプロビジョニングされます。
- アプリを公開する前にインストールしてテストできるように、すべての Marketplace アプリケーションをユーザーがインストールできるようにテスト ドメインを構成します。より制限の厳しいドメインの設定でアプリのインストール プロセスをテストする場合は、アプリを公開した後でこの設定を変更できます。
- テスト用の教師アカウントと生徒アカウントを作成します。デモ ドメインのライセンスが 承認されたら、各テスト アカウントにシートを割り当てます。
Google Cloud プロジェクトを作成します。これを使用して、アドオンの構成、API リクエストの作成、ユーザーの認証と承認を行います。既存の Cloud プロジェクトを使用することもできます。
プロジェクトの OAuth を構成します。
デモ プロジェクトの Google Workspace Marketplace リスティングを作成します。
- アプリの公開設定を [公開] に設定した場合は、すべてのテストユーザーのメールアドレスを [下書きテスター] のリストに追加します。完了したら [下書きを保存] を選択します。
テストユーザーとしてデモ ドメインにログインします。Google Workspace Marketplace リスティング構成の [アプリの URL] からアドオンをインストールします。
開発
- アドオンを開発し、テストユーザーでテストします。
公開
- 公開する
Google Cloud プロジェクトで、次のことを確認します。
- OAuth 同意画面:
- ユーザータイプ: [外部]
- 公開ステータス: [本番環境]
- スコープ: ウェブアプリでリクエストされたすべての スコープを構成します。
- Google Workspace Marketplace SDK アプリ構成画面:
- アプリの公開設定: [公開]
- リスティング タイプ: [非公開]
- スコープ: ウェブアプリでリクエストされたすべての スコープを構成します。
- OAuth 同意画面:
- 公開プロジェクトの Google Workspace Marketplace リスティングを作成します。 テストユーザー アカウントを Marketplace SDK の下書き テスターとして追加します。変更を下書きとして 保存します。
- アドオンコードで公開プロジェクトを更新します。
- 下書きテスターの 1 人として、Marketplace リスティングの URL にアクセスしてアドオンをインストールします。
- 公開プロジェクトの OAuth 検証リクエスト を送信します。下書きテスター アカウントの 1 つを使用して、アドオンのスコープの使用方法を示すショート動画を録画する必要があります。
- Marketplace のレビュー用に公開アドオンを公開します。
- 承認されたら、Marketplace SDK リスティング ステータスを [公開済み] に変更します。
必要となる統合
Classroom アドオンを構築するには、次のものが必要です。
Google シングル サインオン
- Google Identity Platform。Google では、さまざまな認証オプションを提供しています。
- 統合の事例。
ベスト プラクティスに沿ってログインを実装する方法については、スムーズなログインのページをご覧ください。
Classroom アドオンとして Google Workspace Marketplace に送信する
iframe の実装
- 添付ファイルの検出
- 教師ビュー
- 生徒ビュー
- 生徒の提出物のレビュー。生徒の提出物のレビュー iframe は、添付ファイルがアクティビティ タイプの添付ファイルを提供する場合にのみ必要です。
Google Workspace Marketplace
Google Workspace Marketplace では、ドメイン全体または個々の Google Workspace アカウントに追加できるエンタープライズ アプリケーション を紹介しています。Marketplace は Google 管理コンソールと統合されているため、ドメイン 管理者は対象ユーザー向けのアプリをすばやく見つけてインストールし、承認できます。
知っておくべき重要な概念をいくつかご紹介します。
- OAuth の動作と要件。
- Google Workspace Marketplace デベロッパー向けドキュメント。
- Google Workspace Marketplace の教育機関向けセクション。