Classroom でコースワークを表示、作成、変更する
Classroom API の CourseWork エンドポイントを使用して構築できるものは何ですか？
エンドポイントを使用すると、デベロッパーはクラスの課題を表示して管理できます。具体的には、次のすべてを行うことができます。
- ユーザーの課題と質問（
CourseWorkと総称）を表示する CourseWorkの作成、変更、削除- 資料（ドライブのファイル、YouTube 動画、リンク）を
CourseWorkに添付します。 - 生徒の提出物の状態（提出、返却、回収など）を変更する
- 課題の提出の成績を設定する
- 生徒の提出物に資料（ドライブのファイル、YouTube 動画、リンク）を添付する
CourseWork のユースケースの例:
- 採点簿、SIS、レポート システムは、Classroom からアプリケーションに課題と成績を同期できるため、手動でデータを転送する必要がなくなります。
- 学習用アプリケーションは、クラス ストリームに表示される新しい課題を作成できます。生徒が課題を完了すると、アプリケーションは課題を提出したり、成績を設定したり、生徒の課題を添付したり、適切なドライブ フォルダに課題を保存したりできます。
- 教師のユーザーは、アドオンが添付された課題をウェブサイトやアプリケーションから作成できます。
- 生徒のユーザーは、アドオン添付ファイルを含む課題を提出できます。
課題を作成または変更するには、アプリにどのような権限が必要ですか？
通常、アプリケーションは、作成したワークのみを変更できます。つまり、割り当てミューテーション API リクエストでは、割り当て作成時に保存された Google Cloud プロジェクト ID と同じ ID を使用する必要があります。
Google Classroom アドオンには例外があります。Cloud プロジェクトは、アドオン アタッチメントが 1 つ以上含まれているお知らせ、課題、資料にアクセスまたは変更できます。Cloud プロジェクトでは、アドオン アタッチメントが 1 つ以上付いた課題を提出、再利用、返却することもできます。
API リクエストには、適切なユーザーのスコープも必要です。教師は、課題の表示、課題の作成、課題の提出へのリンクの添付、提出物の採点の設定を行うことができます。生徒は課題を表示したり、課題レコードにリンクを添付したり、提出したり、提出した課題を再利用したりできます。ドメイン管理者は CourseWork を表示できますが、書き込み権限はありません。
アプリで課題や提出物に添付できるアイテムの種類
この API では、ドライブ ファイル、YouTube 動画、リンクの添付がサポートされています。ネイティブの Google フォームの添付はまだサポートされていません。
エンドユーザーは Classroom の課題が私のアプリケーションによって作成されたことを知っていますか？
はい。Classroom の UI では、課題を作成した Google Cloud プロジェクトのプロダクト名を使用して、外部で作成された課題を識別します。ユーザーは、外部で作成されたワークを不要として報告できます。また、ユーザーがアプリケーションに発行した認証情報を取り消すことで、ワークを作成したアプリケーションとの接続を切断することもできます。
Classroom の共有ボタンとその他の統合
Classroom の共有ボタンとの統合はすでに完了しています。共有ボタンを使用して作成した課題を変更できますか？
いいえ、現時点では対応していません。割り当てを変更するには、割り当てを作成した同じ Google Cloud プロジェクトを使用する必要があります。
API で質問に回答できますか？
いいえ、現時点では対応していません。質問を作成、変更できます。
Classroom アドオン
プロジェクトの構成
開発中に使用した非公開の Google Cloud プロジェクトを、本番環境で使用できる公開プロジェクトに変換できますか？
限定公開の Google Cloud プロジェクトを公開プロジェクトに変換することはできません。開発用と本番環境用の 2 つの個別のプロジェクトが必要です。
1 つの Google Cloud プロジェクトに 2 つの Google Workspace Marketplace リスティングを登録できますか？
いいえ。1 つの Google Cloud プロジェクトに 2 つの Google Workspace Marketplace リスティングを作成することはできません。
ただし、アドオンをバンドルすることは可能です。これにより、1 つの Google Workspace Marketplace のリスティングで複数のアドオンを表すことができます。このようなリスティングからインストールすると、バンドルのすべてのアドオンが一度にインストールされます。ユーザーは、承認時にバンドル アドオンに必要なすべてのスコープに同意する必要があります。
別の Google Cloud プロジェクトの OAuth クライアントを、Classroom アドオンの Google Cloud プロジェクトで再利用できますか？
いいえ。Classroom アドオンの Google Cloud プロジェクト以外の Google Cloud プロジェクトの OAuth クライアントは機能しません。別の Google Cloud プロジェクトで生成されたアクセス トークンは、Classroom API によって拒否されます。アドオン プロジェクト用に個別の OAuth クライアントを作成する必要があります。
ユーザー エクスペリエンス
ロゴが小さな正方形に収まりません。iframe のタイトルバーのロゴにはどのようなサイズ オプションがありますか？
iframe のタイトルバーは、32×32 のスクエアロゴのみをサポートするように設計されています。この選択は、企業がウェブサイトで使用するファビコンの形状に合わせて行われました。ブランドの整合性を確保するため、このスペースでは同じロゴを使用することをおすすめします。
ドメイン
同じドメイン内のすべての教師と生徒が、インストールしたアドオンにアクセスできますか？
学校管理者は、インストールされているアドオンを表示できる教師を管理できます。Classroom アドオンは、Teaching and Learning または Education Plus のライセンスを持つユーザーのみが使用できます。
ドメイン管理者がアドオンを操作する方法
ドメイン管理者（管理者）は、アドオンを使用できるユーザーを制御します。管理者は、管理者のインストール オプションを使用して、ドメイン全体にアドオンをインストールできます。アドオンを個別にインストールできる場合、ほとんどの管理者はアドオンの許可リストを管理しています。教師はこのリストにあるアドオンをインストールできます。管理者がテスト用にアドオンを個別にインストールすることもできます。
管理者は、アドオンに関する使用状況の統計情報にも関心がある場合があります。プロダクトでサポートされている場合は、独自のサイトの管理者ビューでアドオンの使用状況統計情報を提供することを検討してください。
API
パートナー ページが iframe 内とポップアウト タブのどちらに読み込まれているかを、確実に確認する方法はありますか？
現在のところ、この 2 つを区別する方法はありません。
割り当て可能などの作業項目に生徒の提出物確認の iframe が表示されますか？
生徒の課題の確認用 iframe は、アクティビティ タイプの添付ファイルにのみ表示されます。courses.courseWork.getAddOnContext メソッドを呼び出して、投稿タイプが生徒の提出物をサポートしているかどうかを確認します。supportsStudentWork フィールドを true に設定できるのは、アクティビティである投稿タイプの場合のみです。
アドオン アタッチメントは、アタッチされているストリーム アイテムにアクセスできますか？
はい。アドオン アタッチメントが 1 つ以上含まれている Announcement、CourseWork、CourseWorkMaterial を get または patch にできます。CourseWork StudentSubmission をreclaim、return、turnInできます。
シングル サインオン
Clever のバッジや Classlink を使用して Chromebook にログインした生徒は Google ログインを使用できますか？
はい、Google ログインは引き続き使用できます。
Gmail にアクセスできない場合でも、すべての生徒が適切な形式のメールアドレスを持っているか。
Google Workspace for Education のすべてのユーザーには、Gmail にアクセスできるかどうかに関係なく、Google ID があります。ID はメールアドレスで表されます。特定の Google サービス（Gmail を含む）の ID とアクセス権は異なります。そのため、Gmail が無効になっていても、生徒ユーザーはメールアドレスでログインできます。
生徒がログインできるようにするには、学校の管理者がアプリを事前承認する必要がありますか？
アドオンをインストールするには、ドメイン管理者がアドオンを許可リストに登録する必要があります。必要に応じて、ドメイン管理者はドメインまたは組織部門内のすべてのユーザーに対してアドオンをインストールできます。
フィードバックと一般的な質問
機能リクエストや問題のリクエストを送信するにはどうすればよいですか？
機能リクエストの送信、表示、投票は、公開 Issue Tracker で行えます。
Classroom API で新機能が利用可能になったことを知るにはどうすればよいですか？
API の更新は、リリースノートのページ、デベロッパー フォーラム、公開の Issue Tracker に投稿されます。
Classroom API を使用しています。技術的な質問をするにはどうすればよいですか？
Stack Overflow に google-classroom タグを付けて質問を投稿してください。