開発者のプロセス

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

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

オンボーディング

1. Google Workspace for Education の Teaching & Learning または Plus エディションの テストユーザーが必要です。これらのライセンスのいずれかを使用して Google Workspace for Education ドメインへの管理者アクセス権がない場合は、デベロッパー テスト ドメインを取得する手順を完了してから、ドメイン アップグレード リクエスト フォームを送信してください。 ドメインには、10 個の Google Workspace for Education Plus ライセンスがプロビジョニングされます。
2. アプリを公開する前にインストールしてテストできるように、すべての Marketplace アプリケーションをユーザーがインストールできるようにテスト ドメインを構成します。より制限の厳しいドメインの設定でアプリのインストール プロセスをテストする場合は、アプリを公開した後でこの設定を変更できます。
3. テスト用の教師アカウントと生徒アカウントを作成します。デモ ドメインのライセンスが 承認されたら、各テスト アカウントにシートを割り当てます。

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

   警告: アプリの表示 には特に注意してください。この設定は、エンドユーザーがアドオンにアクセスできるかどうかを制御し、後で変更することはできません。

5. プロジェクトの OAuth を構成します。

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

   • アプリの公開設定を [公開] に設定した場合は、すべてのテストユーザーのメールアドレスを [下書きテスター] のリストに追加します。完了したら [下書きを保存] を選択します。
   キーポイント: **下書き** 状態のプロジェクトでは、変更を公開する前にプレビューしてテストできます。この機能の詳細については、下書きを使用してアプリのリスティングを更新するをご覧ください。

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

開発

7. アドオンを開発し、テストユーザーでテストします。

公開

8. 公開する Google Cloud プロジェクトで、次のことを確認します。
   1. OAuth 同意画面:
      1. ユーザータイプ: [外部]
      2. 公開ステータス: [本番環境]
      3. スコープ: ウェブアプリでリクエストされたすべての スコープを構成します。
   2. Google Workspace Marketplace SDK アプリ構成画面:
      1. アプリの公開設定: [公開]
      2. リスティング タイプ: [非公開]
      3. スコープ: ウェブアプリでリクエストされたすべての スコープを構成します。
9. 公開プロジェクトの Google Workspace Marketplace リスティングを作成します。 テストユーザー アカウントを Marketplace SDK の下書き テスターとして追加します。変更を下書きとして 保存します。
10. アドオンコードで公開プロジェクトを更新します。
11. 下書きテスターの 1 人として、Marketplace リスティングの URL にアクセスしてアドオンをインストールします。
12. 公開プロジェクトの OAuth 検証リクエスト を送信します。下書きテスター アカウントの 1 つを使用して、アドオンのスコープの使用方法を示すショート動画を録画する必要があります。
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 の教育機関向けセクション。