Google Classroom アドオンの一般提供が開始されました。詳しくは、アドオンのドキュメントをご覧ください。

このページは Cloud Translation API によって翻訳されました。

Google Cloud プロジェクトの構成

このページでは、Classroom アドオン用の Google Cloud プロジェクトの作成と構成について説明します。Google Cloud プロジェクトは、OAuth 2.0 を介した Google シングルサインオン（Google SSO）の実装、アドオンによるリクエストの承認、Google Workspace Marketplace ストアでのアドオンのリスティングの管理に使用されます。

アドオンを Marketplace に公開する一般的な情報については、アプリを公開するをご覧ください。

Google Cloud プロジェクトの作成

作成するプロジェクトには 2 種類あります。開発に使用する限定公開プロジェクトと、エンドユーザーがアクセスできる一般公開プロジェクトです。「公開」ラベルと「非公開」ラベルは、Google Workspace Marketplace でのアプリケーションの公開設定を意味します。限定公開 Marketplace アプリケーションは、そのアプリケーションが作成されたドメイン内のユーザーのみがインストールできますが、一般公開 Marketplace アプリケーションはすべての Google Workspace ドメインで使用できます。プロジェクトを公開と限定公開の両方にすることはできないため、これらは 2 つの個別のアプリケーションである必要があります。公開アプリケーションは、マーケットプレイスで利用可能になる前に審査と承認を受ける必要があります。

Google Cloud プロジェクトの一般的な作成情報については、Google Cloud プロジェクトを作成するをご覧ください。

一般公開の Google Cloud プロジェクトを作成する

このプロジェクトは、管理者、教師、生徒がアクセスできるアドオンアプリケーションを表します。公開プロジェクトをリリースまたはインストールするには、Google Workspace Marketplace チームによる審査と承認が必要です。

本番環境ドメインで新しい Google Cloud プロジェクトを作成します。

Google Cloud プロジェクトを作成する

重要: プロジェクトが本番環境ドメインに属していて、そのドメインのユーザーとして Google Cloud コンソールにログインしていることを確認してください。
警告: テストには、プロジェクトのドラフト バージョンを使用する必要があります。現時点では、下書き機能は Google Workspace デベロッパープレビュープログラムでのみご利用いただけます。Cloud プロジェクトを作成したら、申請フォームに記入して Google Workspace デベロッパープレビュープログラムの機能を有効にします。詳しくは、アプリの掲載情報を下書きで更新するをご覧ください。
Cloud プロジェクトで Classroom API を有効にします。

Classroom API を有効にする
Cloud プロジェクトで Google Workspace Marketplace SDK を有効にします。

Google Workspace Marketplace SDK を有効にする
Marketplace SDK のアプリの構成の [アプリの公開設定] を [公開] に設定し、[限定公開] チェックボックスをオンにします。

重要なポイント: 内部開発とテストで使用した限定公開プロジェクトを共有または変換することはできません。
重要なポイント: 公開されていないアプリは、Google Workspace Marketplace でブラウジングまたは検索しても見つかりません。Marketplace SDK の構成内に、アドオンのインストールに使用できるダイレクト URL があります。ストアのリスティングを確認できるのは Google とデベロッパーのみです。アプリを一般公開する準備が整うまでは、アプリを限定公開のままにしておきます。Marketplace SDK の [App Configuration] ページで、アドオンを一覧表示できます。
Marketplace SDK の [ストアのリスティング] ページで必須項目に入力し、[PUBLISH] をクリックします。
アプリが Google Workspace Marketplace チームによって審査されます。担当者は、Marketplace SDK で指定されたデベロッパーのメールアドレスを使用して連絡します。アプリが承認されたら、[公開しない] チェックボックスをオフにして、教師と管理者が Marketplace でアプリを見つけられるようにします。

非公開の Google Cloud プロジェクトを作成する

この非公開プロジェクトは、開発に使用されるアドオンアプリケーションを表します。作成されたドメイン外のユーザーはアクセスできませんが、インストール前に承認を受ける必要はありません。したがって、このプロジェクトを使用して制御された環境でアドオンを開発、テストすることをおすすめします。

非公開プロジェクトを作成するには、Teaching & Learning ライセンスまたは Plus ライセンスを持つ Google Workspace for Education ドメインにアクセスする必要があります。このようなドメインにアクセスできない場合は、次の手順に沿って Google Workspace for Education のデモドメインを設定し、Plus ライセンスにアップグレードして、Classroom アドオン API へのアクセスを許可します。

デベロッパーのテストドメインを取得する手順を完了します。
デモドメインで管理者としてログインしている状態で、新しい Google Cloud プロジェクトを作成します。

Google Cloud プロジェクトを作成する

警告: プロジェクトがデモドメインに属していること、およびデモドメインの管理者アカウントを使用して Google Cloud コンソールにログインしていることを確認してください。
Google Cloud コンソールにアクセスできない場合、または Cloud プロジェクトを作成できない場合は、管理コンソールで次の点を確認してください。
- [アカウント設定] > [年齢に基づくアクセス設定] ページにアクセスし、[このグループまたは組織部門のすべてのユーザーが 18 歳以上です] オプションを選択します。
- [アプリ] > [その他の Google サービス] で、次の操作を行います。
- Google Cloud Platform はどなたでもご利用可能です。
- プロジェクト作成の設定は [ユーザーにプロジェクトの作成を許可する] です。
- Cloud Shell のアクセス設定は [Cloud Shell へのアクセスを許可] です。
デモ用ドメインのアップグレードリクエストフォームに必要事項を入力して送信します。このフォームを送信すると、Google がデモドメインを 10 個のライセンス付きの Google Workspace for Education Plus にアップグレードし、Cloud プロジェクトを Classroom アドオン API で使用できるようになります。

アップグレードと許可リストのプロセスが完了すると、メールが届きます。管理コンソールで、テスト用教師アカウントに Plus ライセンスを割り当てます。[ディレクトリ] > [ユーザー] で、テスト用教師アカウントを作成または選択します。各教師の [ライセンス] で、Google Workspace for Education Plus が [割り当て済み] になっていることを確認します。
Cloud プロジェクトで Classroom API を有効にします。

Classroom API を有効にする
Cloud プロジェクトで Google Workspace Marketplace SDK を有効にします。

Google Workspace Marketplace SDK を有効にする
Marketplace SDK の [アプリの構成] の [アプリの公開設定] を [限定公開] に設定します。
Marketplace SDK の [ストアのリスティング] ページで必須項目に入力し、[PUBLISH] をクリックします。アプリリスティングが公開されると、ドメイン内のユーザーは Google Workspace Marketplace でアプリを検索してインストールできます。また、ストアリスティングページに表示されるアプリの URL にアクセスしてインストールすることもできます。

OAuth 2.0

Classroom API にアクセスするには、ユーザーデータへのアクセスに対する同意が必要です。これらは、ログイン中のユーザーの OAuth スコープへの Google アクセスをリクエストし、その後 Google Classroom への API 呼び出しに使用できるトークンを受け取ることで取得されます。ドメイン管理者がアドオンをインストールするドメインユーザーに代わって同意できるように、Google Workspace Marketplace ストアのリスティングでスコープを設定する必要があります。

Classroom スコープは機密情報であるため、アドオンをリリースする前に OAuth の確認をリクエストする必要があります。確認が完了していないと、ユーザーにはアプリが未確認であるという警告メッセージが表示され、少数のユーザーのみがプロダクトにアクセスできるようになります。適格性確認の詳細については、審査手順の概要をご覧ください。

使用可能なすべてのスコープとその用途の詳細なリストについては、Google API の OAuth スコープページをご覧ください。OAuth の一般的な構成情報については、Workspace ドキュメントの OAuth を構成するをご覧ください。

ユーザー権限

ウェブアプリは、次のスコープの少なくとも 1 つをリクエストする必要があります。

https://www.googleapis.com/auth/userinfo.email: アプリケーションがユーザーのメールアドレスを表示できます。
https://www.googleapis.com/auth/userinfo.profile: アプリは、人物のポートレート、氏名などの個人情報と、ユーザーが一般公開しているその他の個人情報を参照できます。

ユーザーがアドオンでこれらのスコープのいずれかを承認すると、login_hint クエリパラメータで識別されます。このパラメータは、iframe が開かれたときにウェブアプリの任意の URL に渡されます。ユーザーがこれらのスコープのいずれかを承認していない場合、login_hint は送信されません。

login_hint は標準の OpenID Connect パラメータです。Google ログインの使用時や OAuth トークンのリクエスト時に、必要に応じて Google に渡すこともできます。これは、エンドユーザーにとって承認プロセスをスムーズにすることを目的としています。

Classroom アドオンのスコープ

次のスコープは Classroom アドオンに固有のものです。

https://www.googleapis.com/auth/classroom.addons.teacher。すべての API メソッドへのアクセスを許可します。
https://www.googleapis.com/auth/classroom.addons.student: 起動検証オペレーションとアタッチメント読み取りオペレーションへのアクセスを許可します。

ユーザーの認証情報を示す有効な OAuth アクセストークンがある場合でも、API 呼び出しは追加の要件によって制限されます。

すべてのメソッドで、リクエストの courseId で指定されたコースの教師または生徒である必要があります。
添付ファイルの作成、更新、削除、成績の送信を行うには、ユーザーが教師である必要があります。
Google Classroom の特定の投稿に対する呼び出しは、以下のチェックで制限されます。
- 投稿に 1 つ以上の添付ファイルがすでに添付されている場合、アドオンは以下のリクエストを行うことができます。
  - iframe の起動検証
  - アタッチメントの読み取り、更新、削除オペレーション
  - その投稿の成績の更新
- 添付ファイル検出 iframe を初めて開いたときに、アドオンに投稿の添付ファイルがまだない場合もあります。addOnToken クエリパラメータは、次のリクエストに使用できます。
  - 投稿の下に添付ファイルを作成します（addOnToken は必須です）
  - 起動時の検証（addOnToken が指定されている場合は検証されます。アドオンに投稿に既存の添付ファイルがない場合は必須です）

OAuth の確認

Classroom アドオンは、Google API を使用して Google ユーザーのデータにアクセスします。

確認プロセスについて詳しくは、OAuth API 確認に関するよくある質問をご覧ください。

Google Workspace Marketplace リスティング

Google Workspace Marketplace SDK の一般的な構成情報については、Google Workspace Marketplace SDK の有効化と構成と Google Workspace Marketplace ストアの掲載情報の作成をご覧ください。

リスティングに関する考慮事項

一般公開の Google Cloud プロジェクトの Marketplace SDK ストア掲載では、アプリケーションの名前とエンドユーザー向けの説明を指定します。これらの詳細は、[アプリの詳細] で複数の言語で指定できます。

リスティングでは、次のガイドラインを遵守してください。

[App Details] で、以下の操作を行います。
- アプリケーション名に句読点を使用しないでください。たとえば、「My Company: My Add-on」や「My Add-on, by My Company」ではなく、「My Add-on by My Company」を使用します。
- [簡単な説明] と [詳細な説明] に同じテキストを含めないでください。
+ [料金] フィールドに値が選択されていることを確認します。このフィールドには、[無料]、[有料（無料試用あり）]、[有料（無料機能あり）]、[有料] の価格設定オプションがあります。マーケットプレイスのリスティングで費用の金額を指定する必要はありません。
- [カテゴリ] フィールドに値が選択されていることを確認します。Classroom アドオンには、学術リソースや教師と管理者向けツールが適しています。
- 詳しくは、Marketplace のアプリの詳細の説明に記載されている項目をご覧ください。

[グラフィックアセット] で、次の操作を行います。
- 提供された画像および映像が不鮮明ではなく、Google Workspace Marketplace の標準で指定されているサイズを満たしている
- 提供されたスクリーンショットは、アドオンの使用状況を正確に表しているものである。
[サポートリンク] で次の操作を行います。
- アプリケーションの利用規約へのリンクが指定されていることを確認します。
Google API ブランディングガイドラインに準拠していることを確認します。このガイドラインには、使用できる名前と説明が記載されています。
リスティングで Google プロダクトを参照する場合は、商標リストに記載されている形式で名前を使用します。商標（™）記号が指定されている場合は、必ずその記号を含めてください。「Google Docs」ではなく「Google Docs™」を使用してください。

Google のライセンスおよび請求サービスと統合する

Google Workspace Marketplace アプリケーションを Google のライセンスサービスや請求サービスと統合することを検討している場合は、 Marketplace API をご覧ください。

設置の設定

アドオンでは、管理者によるインストールに加えて、個別インストールを許可できます。このページでは、2 つのインストールタイプの違いについて説明します。どちらのインストールタイプを推奨するものではありません。個別のインストールを許可するかどうかは、Google Workspace Marketplace SDK のアプリ構成ページで選択できます。

管理者によるインストール

管理者によるインストールでは、管理者がドメイン内のすべてのアカウント、または特定のアクセスグループまたは組織部門にアドオンを追加できます。管理者インストールを実行できるのはドメイン管理者のみです。必要に応じて、管理者はドメイン内のすべてのユーザーに代わってすべてのアクセススコープに同意できます。管理者がそう選択した場合、ユーザーにアクセススコープへの同意を求めるメッセージは表示されません。

管理者によるインストールに関する考慮事項は次のとおりです。

厳密に管理。管理者は、アドオンにアクセスできるユーザーを制限できます。
ライセンスとの互換性。アプリにライセンスが必要な場合は、管理者によるチャネルインストールにより、対応する機関でライセンスを適切に配布して使用することができます。
エンドユーザーの負担を軽減。管理者がインストールすると、教師と生徒のセットアップ負荷が軽減されます。これにより、クリック回数が減り、混乱の機会が減り、ユーザーエクスペリエンスがよりシームレスになる可能性があります。

管理者によるインストールの実行方法については、ドメイン内に Marketplace アプリをインストールするをご覧ください。組織部門とアクセスグループの詳細については、組織構造の仕組みをご覧ください。

個別インストール

個別インストールの場合は、ユーザーのアカウントにアドオンが追加されます。ユーザーは、インストール時にアドオンのアクセススコープに同意するよう求められます。

個々のインストールに関する考慮事項は次のとおりです。

導入を促進する。より多くのユーザーが Google Workspace Marketplace からアドオンを表示してインストールできるようになります。個別インストールを許可すると、より多くの教師がプロダクトを導入したり、プロダクトを推奨したりするようになります。
管理者によるテスト管理者は、アドオンを個別にインストールしてテストまたは評価してから、より広範なグループに対して承認またはインストールできます。

管理者は、ユーザーに代わってアドオンをインストールするだけでなく、許可リストを維持して、個別にインストールできるアドオンをユーザーがインストールできるようにすることもできます。アドオンが許可リストに登録されていない場合、ユーザーは Google Workspace Marketplace でアドオンの掲載情報は確認できますが、アドオンをインストールすることはできません。代わりに、ドメイン管理者によってアドオンのインストールが許可されていないことを示すメッセージが表示されます。この動作の詳細については、許可リストに登録された Google Workspace Marketplace アプリを管理するをご覧ください。

詳細については、Google Workspace Marketplace のインストール設定に関するドキュメントをご覧ください。

アプリの統合

[Attachment Setup URI] フィールドに、起動 iframe の URL を指定する必要があります。この URL は、アタッチメント検出 iframe の iframe src 値として使用されます。教師が課題に添付するコンテンツやアクティビティを探すには、Attachment Discovery iframe を使用します。

また、アドオンから添付ファイルを許可するすべての URI 接頭辞も指定する必要があります。この機能は、不正な送信元からの添付ファイルを防止することでセキュリティを強化します。

これらのフィールドの詳細については、iframe ガイドページをご覧ください。

テストアカウント

デモドメインにテストアカウントを作成して、限定公開アドオンの動作が正しいことを確認します。生徒の課題レビューの iframe で生徒の切り替えをテストするには、2 つの生徒アカウントが必要です。

推奨されるテストアカウント:

Tammy Teacher、tammy.teacher@<デモドメイン>
Sam Student、sam.student@<デモドメイン>
Sally Student（sally.student@<お使いのデモドメイン>）

新しいテスト用アカウントを作成するには、次の手順を行います。

管理コンソールにログインします。
[ユーザー] に移動します。
[新しいユーザーを追加] をクリックします（図 1 を参照）。
ユーザーの情報を入力し、適切なロールを割り当てます。

[新しいユーザーの追加] をクリックします。 図 1. 管理コンソール内の [新しいユーザーを追加] リンクの場所

新しいテストグループを作成する手順は次のとおりです。

管理コンソールにログインします。
[グループ] に移動します。
[グループを作成] をクリックします（図 2 を参照）。
グループのメンバーとオーナーを入力します。

[グループを作成] をクリックします。 図 2. 管理コンソールの [グループを作成] リンクの場所。