Classroom での CourseWork の表示、作成、変更
Classroom API の CourseWork エンドポイントで何を作成できますか？
このエンドポイントを使用すると、デベロッパーはクラスの課題を表示して管理できます。具体的には、次のすべてを行うことができます。
- ユーザーの課題と質問（まとめて
CourseWorkと呼びます）を表示します。 CourseWorkの作成、変更、削除。CourseWorkに教材（ドライブ ファイル、YouTube 動画、リンク）を添付します。- 生徒の提出物の状態（提出、返却、再提出など）を変更します。
- 課題の提出物の成績を設定します。
- 教材（ドライブのファイル、YouTube 動画、リンク）を生徒の提出物に追加します。
CourseWork のユースケースの例:
- 成績簿、SIS、レポート システムは、Classroom からアプリケーションに課題と成績を同期できるため、手動でデータを転送する必要がなくなります。
- 学習アプリは、クラス ストリームに表示される新しい課題を作成できます。生徒が課題を完了すると、アプリケーションは課題を提出し、成績を設定し、生徒の課題を添付し、適切なドライブ フォルダに課題を保存できます。
- 教師ユーザーは、ウェブサイトやアプリケーションからアドオンの添付ファイル付きの課題を作成できます。
- 生徒は、アドオンの添付ファイルがある課題を提出できます。
課題の作成や変更を行うには、アプリにどのような権限が必要ですか？
通常、アプリケーションは作成した作業のみを変更できます。つまり、CourseWork を変更する API リクエストでは、CourseWork の作成に使用したのと同じ Google Cloud プロジェクト 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 クライアントを作成する必要があります。
ユーザー エクスペリエンス
ロゴが小さな正方形にうまく収まりません。Classroom アドオンの iframe タイトルバーのロゴのサイズにはどのようなオプションがありますか？
iframe のタイトルバーは、32x32 の正方形のロゴのみをサポートするように設計されています。この選択は、企業がウェブサイトで使用するファビコンの形状に合わせるために行われました。ブランドの統一性を保つために、同じロゴをこのスペースで使用することをおすすめします。
ドメイン
同じドメインのすべての教師と生徒が、インストールされたアドオンにアクセスできますか？
ドメイン管理者は、インストールされたアドオンを表示できる教師を制御できます。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 を持っています。特定の Google サービス（Gmail を含む）の ID とアクセス権は別個のものです。Gmail が無効になっていても、生徒ユーザーはメールアドレスを使用して Classroom にログインできます。ID は、ユーザー ID とメールアドレスで表されます。Google Workspace for Education ユーザーはメールアドレスを変更できるため、ユーザー情報を保存する際は、ユーザー ID を主キーとして使用することをおすすめします。
生徒がログインできるようにするには、学校の管理者がアプリを事前承認する必要がありますか？
アドオンをインストールするには、ドメイン管理者がアドオンを許可リストに登録する必要があります。必要に応じて、ドメイン管理者はドメインまたは組織部門内のすべてのユーザーに対してアドオンをインストールできます。
フィードバックと一般的な質問
機能リクエストや問題のリクエストを送信するにはどうすればよいですか？
公開 Issue Tracker では、機能リクエストの送信、表示、投票を行うことができます。
Classroom API で新機能が利用可能になったことを知るにはどうすればよいですか？
API の更新情報は、デベロッパー ニュースレターと公開 Issue Tracker に掲載されます。
Classroom API を使用しています。技術的な質問をするにはどうすればよいですか？
Stack Overflow に google-classroom タグを付けて質問を投稿します。