常見問題

在 Classroom 中查看、建立及修改 CourseWork

我可以在 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 專案可以有兩筆 GWM 清單嗎？

不可以。您無法為單一 Google Cloud 專案建立兩則 GWM 清單。

不過，您也可以「套裝組合」外掛程式。這麼一來，單一 GWM 清單就能代表多個外掛程式。透過這類清單安裝後，系統會同時安裝套件中的「所有」外掛程式。使用者在授權時，必須同意隨附外掛程式所需的所有範圍。

套裝組合還有其他兩個注意事項：

  1. Classroom 外掛程式僅供 Teaching and Learning Upgrade 或 Education Plus SKU 訂閱者使用。

  2. 外掛程式 API 目前處於搶先體驗階段，僅供參與的開發人員和 Google Cloud 專案使用。如果隨附的外掛程式仰賴未參與的 Google Cloud 專案，則可能無法正常運作。

其他 Google Cloud 專案的 OAuth 用戶端可以在 Google Cloud 專案中重複使用 Classroom 外掛程式嗎？

不可以，除了 Classroom 外掛程式 Google Cloud 專案之外，其他 Google Cloud 專案的 OAuth 用戶端無法使用。其他 Google Cloud 專案產生的存取權杖會遭到 Classroom API 拒絕。您必須為外掛程式專案建立個別的 OAuth 用戶端。

使用者體驗

我們的標誌在小正方形中並不符合需求，iframe 標題列提供哪些標誌尺寸？

iframe 標題列的設計只支援 32x32 正方形標誌。這個選擇的依據是公司在網站中使用的小圖示，也是我們在空間中使用相同標誌，以確保品牌一致性。

網域

位於同一網域的所有老師和學生是否都能使用已安裝的外掛程式？

學校管理員可以控管哪些老師能查看已安裝的外掛程式。

網域管理員如何與外掛程式互動？

網域管理員 (系統管理員) 可控管哪些使用者能使用您的外掛程式。他們可以使用管理員安裝選項，為整個網域安裝外掛程式。如果使用者可以個別安裝外掛程式，請注意，大多數管理員都會維護外掛程式許可清單，而老師可以自行安裝這份清單中的外掛程式。管理員也可以選擇為個別安裝外掛程式以進行測試。

管理員可能也想瞭解與外掛程式的使用統計資料。如果您的產品支援這項功能，請考慮在您網站的管理員檢視畫面中，提供外掛程式的使用統計資料。

API

哪一項是可靠的方式，才能得知合作夥伴頁面是載入 iframe 或彈出式分頁內？

目前沒有可以區分兩者的方法。

哪些可指派的作業項目會顯示學生作業回顧 iframe？

學生作業回顧 iframe 僅供活動類型的附件使用。呼叫 courses.courseWork.getAddOnContext 方法，瞭解貼文類型是否支援學生作業。只有活動的貼文類型，supportsStudentWork 欄位才能設為 true。

在搶先體驗計畫期間，是否應對 API 進行破壞性變更？

外掛程式 API 仍處於開發階段。因此，API 可能會發生破壞性變更，導致先前成功的要求失敗或行為出現差異。如有任何破壞性變更，系統會事先透過開發人員論壇通知您。

外掛程式附件可以存取附加的串流項目嗎？

需要。您可以 get 或 patch 任何包含至少一個外掛程式附件的 Announcement、CourseWork 或 CourseWorkMaterial。您可以為CourseWork StudentSubmissionreclaim、return或turnIn。

Classroom 外掛程式何時會公開發布？

自 2022 年夏天起，所有使用者都可以使用 Classroom 外掛程式。我們預計於 2024 年正式發布外掛程式 API。

單一登入

可以，他們仍可使用 Google 登入功能。

即使他們沒有 Gmail 存取權，每位學生都有格式正確的電子郵件地址嗎？

無論 Google Workspace for Education 使用者是否可存取 Gmail，每位 Google Workspace for Education 使用者都有 Google 身分。身分會以電子郵件地址表示。對任何特定 Google 服務 (包括 Gmail) 的身分和存取權不同。因此，即使 Gmail 已停用，學生使用者仍可使用自己的電子郵件地址登入。

學校管理員是否必須預先核准應用程式，學生才能登入？

網域管理員必須先將外掛程式加入許可清單才能安裝。此外，網域管理員也可以為網域或機構單位中的所有使用者安裝外掛程式。

意見回饋和一般問題

如何提出功能要求或要求問題？

您可以透過公開的 Issue Tracker 提交、查看功能要求，並參與投票。

如何得知 Classroom API 推出新功能？

我們會將 API 更新內容發布在版本資訊頁面、我們的開發人員論壇和公開版 Issue Tracker。

我使用 Classroom API，如何詢問技術問題？

在 Stack Overflow 上張貼問題並加上 google-classroom 標記。