Classroom アドオンを開発する手順の概要を以下に示します。
オンボーディング
- テストユーザーとして、Teaching & Learning または Plus の Google Workspace for Education エディションが必要です。これらのライセンスのいずれかを持つ Google Workspace for Education ドメインの管理者権限がない場合は、デベロッパーのテストドメインを取得する手順を行い、ドメイン アップグレードのリクエスト フォームを送信してください。このドメインには、10 個の Google Workspace for Education Plus ライセンスがプロビジョニングされます。
Google Cloud プロジェクトを作成します。これを使用して、アドオンの構成、API リクエストの実行、ユーザーの認証と認可を行います。既存の Cloud プロジェクトを使用することもできます。
- [アプリの公開設定] を [公開] に設定した場合は、この Cloud プロジェクトで Google Workspace デベロッパー プレビュー プログラムに参加してください。これにより、Cloud プロジェクトでドラフト機能が有効になります。これはアプリケーションをテストするために必要です。詳しくは、アプリの掲載情報を下書きで更新するをご覧ください。
テスト用の教師と生徒のアカウントを作成します。デモドメインのライセンスが承認されたら、各テスト アカウントにシートを割り当てます。
プロジェクトに OAuth を構成します。
デモ プロジェクト用に Google Workspace Marketplace のリスティングを作成します。
- [アプリの公開設定] を [公開] に設定した場合は、すべてのテストユーザーのメールアドレスを [ドラフト テスター] のリストに追加します。完了したら、[下書きを保存] を選択します。
デモドメインにテストユーザーとしてログインします。Google Workspace Marketplace のリスティング構成で、アプリの URL からアドオンをインストールします。
開発環境
- アドオンを開発し、テストテスターとともにテストします。
公開中
-
公開する Google Cloud プロジェクトで、次のことを確認します。
- OAuth 同意画面:
- User Type: 外部
- 公開ステータス: 本番環境
- スコープ: ウェブアプリでリクエストされる すべてのスコープを構成します。
- Google Workspace Marketplace SDK アプリの構成画面:
- アプリの公開設定: 公開
- リスティング タイプ: 限定公開
- スコープ: ウェブアプリでリクエストされる すべてのスコープを構成します。
- OAuth 同意画面:
- 公開プロジェクト用に Google Workspace Marketplace のリスティングを作成します。テストユーザー アカウントを Marketplace SDK ドラフト テスターとして追加します。変更を下書きとして保存します。[ドラフト] オプションが表示されない場合は、プロジェクトを Google Workspace デベロッパー プレビュー プログラムに登録してください。
- アドオンコードで一般公開プロジェクトを更新します。
- ドラフト テスターの 1 人として、 Marketplace のリスティング URL にアクセスして、アドオンをインストールします。
- 公開プロジェクトの OAuth 検証リクエストを送信します。ドラフト テスター アカウントのいずれかを使用して、アドオン スコープの使用方法を示す短い動画を録画する必要があります。
- 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 の教育セクション。