開発者のプロセス

以下では、Classroom アドオンを開発する際の手順の概要を説明します。

オンボーディング

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

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

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

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

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

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

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

開発

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

公開

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

必要となる統合

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

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

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

  2. Classroom アドオンとして Google Workspace Marketplace に送信する

  3. iframe の実装

Google Workspace Marketplace

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

理解しておくべき重要な概念をいくつかご紹介します。