在 Classroom 中查看、建立及修改課程作業
我可以使用 Classroom API 中的 CourseWork 端點建構哪些內容？
開發人員可以透過這些端點查看及管理課程中的作業。具體而言，您可以執行下列所有操作：
- 查看使用者的指派和問題 (統稱為
CourseWork) - 建立、修改及刪除
CourseWork - 將教材 (雲端硬碟檔案、YouTube 影片、連結) 附加至
CourseWork - 變更學生的繳交狀態 (例如繳交、發還、收回)
- 為繳交作業設定成績
- 在學生繳交的作業中附加相關資料 (雲端硬碟檔案、YouTube 影片、連結)
CourseWork 的部分用途範例：
- 成績簿、學生資訊系統或報表系統可以將作業和成績從 Classroom 同步至應用程式，省去手動轉移資料的麻煩
- 學習應用程式可以建立顯示在課程訊息串中的新作業。學生完成作業後，應用程式可繳交作業、設定成績、附加學生作業，以及將作業儲存在適當的雲端硬碟資料夾。
- 老師使用者可以從您的網站或應用程式建立含有外掛程式附件的作業。
- 學生使用者可以繳交附加檔案的作業。
我的應用程式需要哪些權限，才能建立或修改指派？
一般而言，應用程式只能修改自身建立的工作。換句話說，任何作業變異 API 要求都必須使用在建立作業時儲存的 Google Cloud 專案 ID。
Google Classroom 外掛程式是這項規則的例外狀況。Cloud 專案可以存取或修改任何含有一或多個外掛程式附件的公告、作業或素材。Cloud 專案也可以提交、回收或退回含有一個或多個外掛程式附件的作業。
API 要求也需要正確的使用者範圍。老師可以查看作業、建立作業、附加作業繳交內容的連結，以及設定繳交作業的成績。學生可以查看作業、將連結附加至作業記錄，並繳交及取回作業。網域管理員可以查看 CourseWork，但不具備寫入權限。
應用程式可以將哪些類型的項目附加至作業或提交內容？
這個 API 支援附加雲端硬碟檔案、YouTube 影片和連結。目前不支援附加原生 Google 表單。
使用者是否知道 Classroom 中的作業是由我的應用程式建立？
可以。Classroom UI 會使用建立該作業的 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 用戶端，是否可以用於 Google Cloud 專案的 Classroom 外掛程式？
不可以。除了 Classroom 外掛程式 Google Cloud 專案以外，Google Cloud 專案的 OAuth 用戶端無法運作。Classroom API 會拒絕其他 Google Cloud 專案產生的存取權杖。您必須為外掛程式專案建立獨立的 OAuth 用戶端。
使用者體驗
我們的標誌無法容納在小型正方形中。iframe 標題列中是否有標誌大小選項？
iframe 標題列僅支援 32x32 方形標誌。這個選項是配合公司網站使用的網站小圖示形狀而做選擇，我們的指引就是在空間中使用相同的標誌，以維持品牌一致性。
網域
同一網域中的所有老師和學生是否都能存取已安裝的外掛程式？
學校管理員可以控制哪些老師可以查看已安裝的外掛程式。只有具備 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，學生使用者還是可以用自己的電子郵件地址登入。
學校管理員是否需要預先核准應用程式，才能讓學生登入？
網域管理員必須先核准外掛程式，才能安裝。網域管理員可以選擇為網域或機構單位中的所有使用者安裝外掛程式。
意見回饋和一般問題
如何提出功能要求或回報問題？
您可以在公開的 Issue Tracker 中提交、查看及對功能要求進行投票。
如何得知 Classroom API 推出新功能？
我們已在版本資訊頁面、我們的開發人員論壇和公開 Issue Tracker 上公布 API 的更新資訊。
我使用的是 Classroom API，如何提出技術問題？
在 Stack Overflow 上發布問題，並加上 google-classroom 標記。