開発者のプロセス

Classroom アドオンを開発する手順の概要を以下に示します。

重要: Google for Education のデベロッパー向けお知らせグループに登録すると、アドオンや Google Classroom API に関する最新情報をお受け取りいただけます。

オンボーディング

1. テストユーザーとして、Teaching & Learning または Plus の Google Workspace for Education エディションが必要です。これらのライセンスのいずれかを持つ Google Workspace for Education ドメインの管理者権限がない場合は、デベロッパーのテストドメインを取得する手順を行い、ドメイン アップグレードのリクエスト フォームを送信してください。このドメインには、10 個の Google Workspace for Education Plus ライセンスがプロビジョニングされます。

2. Google Cloud プロジェクトを作成します。これを使用して、アドオンの構成、API リクエストの実行、ユーザーの認証と認可を行います。既存の Cloud プロジェクトを使用することもできます。

   警告: アプリの表示には特に注意してください。この設定は、アドオンにエンドユーザーがアクセスできるようにするかどうかを制御します。この設定を後で変更することはできません。
   • [アプリの公開設定] を [公開] に設定した場合は、この Cloud プロジェクトで Google Workspace デベロッパー プレビュー プログラムに参加してください。これにより、Cloud プロジェクトでドラフト機能が有効になります。これはアプリケーションをテストするために必要です。詳しくは、アプリの掲載情報を下書きで更新するをご覧ください。

3. テスト用の教師と生徒のアカウントを作成します。デモドメインのライセンスが承認されたら、各テスト アカウントにシートを割り当てます。

4. プロジェクトに OAuth を構成します。

5. デモ プロジェクト用に Google Workspace Marketplace のリスティングを作成します。

   • [アプリの公開設定] を [公開] に設定した場合は、すべてのテストユーザーのメールアドレスを [ドラフト テスター] のリストに追加します。完了したら、[下書きを保存] を選択します。

6. デモドメインにテストユーザーとしてログインします。Google Workspace Marketplace のリスティング構成で、アプリの URL からアドオンをインストールします。

開発環境

7. アドオンを開発し、テストテスターとともにテストします。

公開中

8. 公開する Google Cloud プロジェクトで、次のことを確認します。
   1. OAuth 同意画面:
      1. User Type: 外部
      2. 公開ステータス: 本番環境
      3. スコープ: ウェブアプリでリクエストされる すべてのスコープを構成します。
   2. Google Workspace Marketplace SDK アプリの構成画面:
      1. アプリの公開設定: 公開
      2. リスティング タイプ: 限定公開
      3. スコープ: ウェブアプリでリクエストされる すべてのスコープを構成します。
9. 公開プロジェクト用に Google Workspace Marketplace のリスティングを作成します。テストユーザー アカウントを Marketplace SDK ドラフト テスターとして追加します。変更を下書きとして保存します。[ドラフト] オプションが表示されない場合は、プロジェクトを Google Workspace デベロッパー プレビュー プログラムに登録してください。
10. アドオンコードで一般公開プロジェクトを更新します。
11. ドラフト テスターの 1 人として、 Marketplace のリスティング URL にアクセスして、アドオンをインストールします。
12. 公開プロジェクトの OAuth 検証リクエストを送信します。ドラフト テスター アカウントのいずれかを使用して、アドオン スコープの使用方法を示す短い動画を録画する必要があります。
13. Marketplace での審査のために 一般公開アドオンを公開します。
14. 承認されたら、Marketplace SDK リスティング ステータスをリスト済みに変更します。

必要な統合

Classroom アドオンを作成するには、次のものが必要です。

1. Google シングル サインオン

   • Google Identity Platform。Google はさまざまな認証オプションを提供しています。
   • 統合ケーススタディ。

   ベスト プラクティスに沿ってログインを実装する方法については、スムーズなログインページをご覧ください。

2. Classroom アドオンとしての Google Workspace Marketplace への提出

3. iframe の実装

   • 添付ファイルの検出
   • 教師に表示される画面
   • 生徒に表示される画面
   • 生徒の提出物の確認。生徒の提出物の確認の iframe は、添付ファイルでアクティビティ タイプの添付ファイルを提供する場合にのみ必要です。

Google Workspace Marketplace

Google Workspace Marketplace には、ドメイン全体または個々の Google Workspace アカウントに追加できるエンタープライズ アプリケーションが表示されます。Marketplace は Google 管理コンソールと統合されているため、ドメイン管理者は対象ユーザーのアプリをすばやく検索、インストール、承認できます。

知っておくべき重要なコンセプトは次のとおりです。

• OAuth の動作と要件
• Google Workspace Marketplace デベロッパー向けドキュメント
• Google Workspace Marketplace の教育セクション。