開発者のプロセス

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

必要となる統合

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

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

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

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

  3. iframe の実装

Google Workspace Marketplace

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

理解しておくべき主な概念は次のとおりです。