Classroom での CourseWork の表示、作成、変更
Classroom API で CourseWork エンドポイントを使用して作成できるものは何ですか？
新しいエンドポイントを使用すると、デベロッパーはクラスの作業を表示、管理できます。具体的には、次のすべてを行うことができます。
- ユーザーの課題と質問（総称して「CourseWork」と呼びます）を表示する
- CourseWork の作成、変更、削除
- CourseWork に資料（ドライブ ファイル、YouTube 動画、リンク）を添付する
- 生徒の提出物の状態を変更する（提出、返却、再利用など）
- 課題の提出物の成績を設定する
- 生徒の提出物に資料（ドライブのファイル、YouTube 動画、リンク）を添付する
CourseWork の使用例には次のようなものがあります。
- 採点簿、SIS、レポート システムは、Classroom の課題と成績をアプリケーションに同期できるため、データを手動で転送する必要がなくなります。
- 学習用アプリケーションは新しい課題を作成し、クラス ストリームに表示されます。生徒が課題を完了すると、アプリケーションは課題の提出、成績の設定、生徒の提出物の添付、適切なドライブ フォルダへの保存を行うことができます。
- 教師のユーザーは、ウェブサイトまたはアプリケーションからアドオン添付ファイルを使用して課題を作成できます。
- 生徒ユーザーは、アドオンの添付ファイルがある課題を提出できます。
アプリケーションで割り当てを作成または変更するために必要な権限
通常、アプリケーションで変更できるのは自身が作成した処理のみです。つまり、割り当てミューテーション API リクエストでは、割り当て作成時に保存されたものと同じ 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 つの GWM リスティングを作成できますか？
いいえ。1 つの Google Cloud プロジェクトに GWM の掲載情報を 2 つ作成することはできません。
ただし、アドオンをバンドルすることは可能です。これにより、1 つの GWM リスティングで複数のアドオンを表すことができます。このような一覧からインストールすると、バンドル内のすべてのアドオンが一度にインストールされます。ユーザーは承認時に、バンドルされたアドオンに必要なすべてのスコープに同意する必要があります。
バンドルについては、他にも 2 つの考慮事項があります。
Classroom アドオンは、Teaching & Learning Upgrade SKU または Education Plus SKU の定期購入者のみが利用できます。
アドオン API は早期アクセス版であり、参加しているデベロッパーと Google Cloud プロジェクトに制限されています。バンドルされたアドオンは、参加していない Google Cloud プロジェクトに依存している場合、意図したとおりに動作しない可能性があります。
別の Google Cloud プロジェクトの OAuth クライアントを、Classroom アドオン用の Google Cloud プロジェクトで再利用できますか？
いいえ。Classroom アドオンの Google Cloud プロジェクト以外の Google Cloud プロジェクトの OAuth クライアントは動作しません。別の Google Cloud プロジェクトによって生成されたアクセス トークンは、Classroom API によって拒否されます。アドオン プロジェクトには個別の OAuth クライアントを作成する必要があります。
ユーザー エクスペリエンス
Google のロゴが小さな正方形にうまく収まりません。iframe のタイトルバーのロゴにはどのようなサイズオプションがありますか？
iframe のタイトルバーは、32×32 の正方形のロゴのみをサポートするように設計されています。これは、企業が自社のウェブサイトで使用するファビコンの形状に合わせて選択されており、ブランドの一貫性を保つためにスペースで同じロゴを使用することが Google の指針です。
ドメイン
インストールしたアドオンには、同じドメイン内のすべての教師と生徒がアクセスできますか？
学校の管理者は、インストールされたアドオンをどの教師に表示するかを制御できます。
ドメイン管理者がアドオンを操作する仕組み
アドオンを使用できるユーザーは、ドメイン管理者（管理者）によって管理されます。管理者のインストール オプションを使用して、ドメイン全体にアドオンをインストールできます。アドオンを個別にインストールできる場合は、ほとんどの管理者がアドオンの許可リストを管理しています。教師はこのリストにあるアドオンをインストールできます。管理者は、テストのためにアドオンを個別にインストールすることもできます。
管理者も、アドオンの使用統計情報に関心を持つかもしれません。自社サービスでサポートされている場合は、自社サイトの管理者ビューでアドオンの使用統計情報を提供することを検討してください。
API
パートナーのページが iframe またはポップアウト タブ内に読み込まれているかどうかを確認する、信頼できる方法はどれですか。
現在のところ、この 2 つを区別する方法はありません。
どの割り当て可能な作業アイテムに生徒の提出物レビューの iframe が割り当てられますか？
「生徒の提出物の確認」iframe は、アクティビティ タイプの添付ファイルにのみ提供されます。
courses.courseWork.getAddOnContext メソッドを呼び出して、投稿タイプが生徒の提出物をサポートしているかどうかを確認します。supportsStudentWork フィールドを true にできるのは、アクティビティの投稿タイプの場合のみです。
早期アクセス プログラム中に、API に互換性を破る変更が行われることはありますか？
このアドオン API はまだ開発中です。そのため、API に互換性を破る変更があり、以前に成功したリクエストが失敗したり、動作が異なる場合があります。互換性を破る変更については、デベロッパー フォーラムで事前に通知できます。
アドオンの添付ファイルは、添付先のストリーム アイテムにアクセスできますか？
はい。1 つ以上のアドオンのアタッチメントを含む Announcement、CourseWork、または CourseWorkMaterial を get または patch できます。CourseWork StudentSubmission に対して reclaim、return、turnIn を実行できます。
Classroom アドオンはいつ一般公開されますか？
Classroom アドオンは、2022 年夏からすべてのエンドユーザーにご利用いただけます。アドオン API は 2024 年内にデベロッパー向けに一般提供される予定です。
シングル サインオン
Clever バッジまたは Classlink を使用して Chromebook にログインしている生徒は、Google ログインを使用できますか？
はい、Google ログインは引き続き使用できます。
Gmail にアクセスできない生徒も含め、すべての生徒が正しい形式のメールアドレスを持っているか
Gmail にアクセスできるかどうかにかかわらず、すべての Google Workspace for Education ユーザーは Google ID を持っています。ID はメールアドレスで表されます。ID と特定の Google サービス（Gmail を含む）へのアクセスは異なります。このため、Gmail が無効になっている場合でも、学生ユーザーはメールアドレスでログインできます。
生徒のログインを許可するために、学校の管理者がアプリを事前承認する必要がありますか？
アドオンをインストールするには、ドメイン管理者がアドオンを許可リストに登録する必要があります。必要に応じて、ドメイン管理者はドメインまたは組織部門内のすべてのユーザーに対してアドオンをインストールできます。
フィードバックと一般的な質問
機能リクエストや問題のリクエストはどのように送信すればよいですか？
公開されている Issue Tracker で機能リクエストの送信、表示、投票を行うことができます。
Classroom API の新機能が利用可能になったかどうかを知るにはどうすればよいですか？
API のアップデートは、リリースノート ページ、デベロッパー フォーラム、公開 Issue Tracker に投稿されています。
Classroom API を使用しています。技術的な質問の方法は？
質問は、google-classroom タグを付けて Stack Overflow に投稿してください。