在 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 專案？
否，除了 Classroom 外掛程式 Google Cloud 專案以外，其他 Google Cloud 專案的 OAuth 用戶端都無法運作。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。
單一登入
使用 Clever 徽章或 Classlink 登入 Chromebook 的學生是否可以使用 Google 登入功能？
是的，他們仍可使用 Google 帳戶登入。
即使學生沒有 Gmail 存取權，是否每個人都有正確格式的電子郵件地址？
無論是否有權存取 Gmail，每位 Google Workspace for Education 使用者都有 Google 身分。任何特定 Google 服務 (包括 Gmail) 的身分和存取權皆不相同。即使已停用 Gmail，學生使用者仍可使用電子郵件地址登入 Classroom。身分會以使用者 ID 和電子郵件地址表示。Google Workspace for Education 使用者可以變更電子郵件地址，因此建議您在儲存使用者資訊時，使用使用者 ID 做為主鍵。
學校管理員是否需要預先核准應用程式，才能讓學生登入？
網域管理員必須先核准外掛程式，才能安裝。網域管理員可以選擇為網域或機構單位中的所有使用者安裝外掛程式。
意見回饋和一般問題
如何提交功能要求或回報問題？
您可以在公開的 Issue Tracker 中提交、查看及對功能要求進行投票。
如何得知 Classroom API 何時推出新功能？
我們會在開發人員電子報和公開問題追蹤工具上發布 API 更新。
我使用的是 Classroom API。如何提出技術問題？
在 Stack Overflow 上發布問題，並加上 google-classroom 標記。