開発者のプロセス

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

オンボーディング

  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 からアドオンをインストールします。

開発

  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. Draft のテスターの 1 人として、 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 管理コンソールと統合されているため、ドメイン管理者は対象ユーザー向けのアプリをすばやく見つけてインストールし、承認することができます。

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