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 x 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 を使用しています。技術的な質問をするにはどうすればよいですか？
質問は、google-classroom タグを使用して Stack Overflow に投稿してください。