開発者のプロセス

以下では、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. ドラフト版テスターの方は、 Marketplace のリスティング URL にアクセスしてアドオンをインストールしてください。
12. 公開プロジェクトの OAuth 確認リクエストを送信します。ドラフト テスター アカウントのいずれかを使用して、アドオン スコープの使用方法を示す短い動画を録画する必要があります。
13. 一般公開アドオンを公開して、Marketplace の審査を受けます。
14. 承認が完了したら、Marketplace SDK リスティングのステータスを [listed] に変更します。

必要となる統合

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 の教育セクション。