在 Classroom 中查看、建立及修改課堂作業
我可以使用 Classroom API 中的 CourseWork 端點建構哪些內容？
開發人員可透過這些端點查看及管理課程作業。具體來說，你可以執行下列所有操作：
- 查看使用者的指派作業和問題 (統稱為
CourseWork)。 - 建立、修改及刪除
CourseWork。 - 將教材 (雲端硬碟檔案、YouTube 影片、連結) 附加至「
CourseWork」。 - 變更學生的作業狀態 (例如繳交、退回、收回)。
- 設定作業繳交內容的成績。
- 將教材 (雲端硬碟檔案、YouTube 影片、連結) 附加至學生的提交內容。
「CourseWork」的一些用途範例：
- 成績單、學生資訊系統或報表系統可將 Classroom 中的作業和成績同步至應用程式，免除手動轉移資料的麻煩。
- 學習應用程式可以建立新作業，並顯示在課程訊息串中。學生完成作業後，應用程式可以繳交作業、設定成績、附加學生作業，並將作業儲存在適當的雲端硬碟資料夾中。
- 老師使用者可以從您的網站或應用程式建立外掛程式附件，並將其附加至作業。
- 學生使用者可以繳交附加外掛程式的作業。
應用程式需要哪些權限才能建立或修改作業？
一般來說，應用程式只能修改自己建立的工作。換句話說，任何修改 CourseWork 的 API 要求都必須使用建立 CourseWork 時所用的 Google Cloud 專案 ID。
Google Classroom 外掛程式是這項規則的例外狀況。如果公告、作業或教材附加一或多個外掛程式附件，Cloud 專案就能存取或修改這些項目。如果作業附加一或多個外掛程式，Cloud 專案也可以繳交、收回或發還作業。
API 要求也需要正確的使用者範圍。老師可以查看作業、建立作業、在作業繳交內容中附加連結，以及設定繳交作業的評分。學生可以查看作業、將連結附加至作業記錄，以及繳交和收回作業。網域管理員可以查看 CourseWork，但不具備寫入權限。
學生可以在作業或提交內容中附加哪些類型的項目？
API 支援附加雲端硬碟檔案、YouTube 影片和連結。目前不支援附加 Google 原生表單。
終端使用者是否知道 Classroom 中的作業是由我的應用程式建立？
可以。Classroom 使用 Google Cloud 專案的產品名稱，識別外部建立的作業。使用者可以將外部建立的工作回報為不想要的內容，也可以撤銷使用者發給應用程式的憑證，藉此中斷應用程式與工作之間的連結。
Classroom 分享按鈕和其他整合功能
我已整合 Classroom 分享按鈕，我可以修改使用分享按鈕建立的作業嗎？
目前還不行。如要修改指派事項，要求必須使用建立指派事項時所用的 Google Cloud 專案。
我可以在 API 中回答問題嗎？
目前還不行。你可以建立及修改問題。
Classroom 外掛程式
專案設定
我能否將開發期間使用的私人 Google Cloud 專案，轉換為可在正式環境中使用的公開專案？
否，您無法將私人 Google Cloud 專案轉換為公開專案。您需要兩個不同的專案，一個用於開發，另一個用於正式環境。
單一 Google Cloud 專案可以有兩個 Google Workspace Marketplace 應用程式資訊嗎？
否。您無法為單一 Google Cloud 專案建立兩個 Google Workspace Marketplace 項目。
不過，您可以組合外掛程式。這樣一來，單一 Google Workspace Marketplace 項目就能代表多個外掛程式。從這類資訊安裝外掛程式時，系統會一併安裝組合中的所有外掛程式。授權時，使用者必須同意套裝組合外掛程式所需的所有範圍。
是否能將其他 Google Cloud 專案的 OAuth 用戶端，重複用於 Classroom 外掛程式的 Google Cloud 專案？
不可以。OAuth 用戶端必須來自 Classroom 外掛程式 Google Cloud 專案，否則無法運作。Classroom API 會拒絕其他 Google Cloud 專案產生的存取權杖。您必須為外掛程式專案建立個別的 OAuth 用戶端。
使用者體驗
我們的標誌不適合放在小正方形中，Classroom 外掛程式 iFrame 標題列的標誌有哪些尺寸選項？
iframe 標題列的設計僅支援 32x32 的方形標誌。我們選擇這個形狀，是為了配合公司在網站上使用的 Favicon 形狀，並建議在空間中使用相同的標誌，以確保品牌一致性。
網域
如果老師和學生位於相同網域，是否都能存取已安裝的增益集？
網域管理員可以控管哪些老師能查看已安裝的外掛程式。只有具備 Teaching & Learning 或 Education Plus 授權的使用者，才能使用 Classroom 外掛程式。
網域管理員如何與外掛程式互動？
網域管理員可以控管哪些人可以使用外掛程式。他們可以使用管理員安裝選項，為整個網域安裝外掛程式。如果外掛程式可供個別安裝，請注意，大多數管理員都會維護外掛程式許可清單，清單上的老師可以自行安裝外掛程式。管理員也可能會選擇個別安裝外掛程式，以進行測試。
管理員可能也會對外掛程式的使用統計資料感興趣。如果產品支援，請考慮在自家網站的管理員檢視畫面中提供外掛程式使用情況統計資料。
API
如何可靠地判斷外掛程式內容是否載入至 iframe 或新分頁？
目前沒有方法可區分兩者。
哪些可指派的作業項目會顯示「學生作業審查」iframe？
學生作業審查 iframe 僅適用於活動類型的附件。
呼叫 courses.courseWork.getAddOnContext 方法，判斷貼文類型是否支援學生作業。supportsStudentWork 欄位只能用於活動類型的貼文。true
外掛程式附件可以存取所附加的串流項目嗎？
可以。您可以get或patch任何包含至少一個外掛程式附件的 Announcement、CourseWork 或 CourseWorkMaterial。您可以reclaim、return 或 turnIn CourseWork StudentSubmission。
單一登入
學生能否使用 Google 登入 Chromebook？他們目前是使用 Clever 徽章或 Classlink 登入。
可以，他們仍可使用 Google 登入。
即使學生無法存取 Gmail，是否仍有格式正確的電子郵件地址？
無論是否能存取 Gmail，每位 Google Workspace for Education 使用者都有 Google 身分。任何特定 Google 服務 (包括 Gmail) 的身分和存取權都不同。即使停用 Gmail，學生使用者仍可透過電子郵件地址登入 Classroom。身分會以使用者 ID 和電子郵件地址表示。Google Workspace for Education 使用者可以變更電子郵件地址，因此建議您在儲存使用者資訊時，使用使用者 ID 做為主鍵。
學校管理員是否需要預先核准應用程式，才能允許學生登入？
網域管理員必須先將外掛程式加入允許清單，才能安裝外掛程式。 網域管理員也可以選擇為網域或機構單位中的所有使用者安裝外掛程式。
意見回饋與一般問題
如何提交功能要求或回報問題？
您可以在公開的 Issue Tracker 中提交、查看及投票表決功能要求。
如何得知 Classroom API 何時推出新功能？
我使用 Classroom API。如何提出技術問題？
在 Stack Overflow 上提問並加上 google-classroom 標記。