CourseWork 整合

開發人員可以使用 Google Classroom API，與 Google Classroom 中的課程互動。以這種方式使用 API 的應用程式稱為 CourseWork 整合。

這項整合路徑通常用於建立及評分連結至 Classroom 以外資源的作業。與 Classroom 分享按鈕相比，這項功能可讓開發人員更容易管理課程。

運作方式

CourseWork 整合功能的核心功能，就是使用 Classroom API 建立及管理作業、公告和課程教材。

CourseWork 整合功能可讓老師在網站或應用程式中發現、指派及評分內容，這就是常見使用者歷程的其中一個例子：

1. 老師使用者登入您的網站。
2. 老師尋找或製作要與學生分享的內容。老師按一下網站上的按鈕，即可將內容傳送至 Google Classroom。
3. 您的應用程式會向 courses.courseWork.create 發出要求。要求主體包含 CourseWork 物件，其中包含：
   • 目的地課程 ID。
   • 作業的標題。
   • 作業的文字說明。
   • link Material，其中包含老師所選內容的網址。
   • 選用項目，所選內容可取得的最高分數。
4. Classroom 會顯示新作業，並附上連結。連結是指 create 要求中指定的網址。請參閱圖 1 查看範例。
5. Classroom 成績單也會顯示作業的新資料欄，包括提供的最高分數。
6. 學生收到作業後，按一下 link Material 即可在新分頁中開啟提供的網址，並查看或完成網站上的內容。您可以選擇提供控制項，讓學生繳交作業。
7. 您也可以向 courses.courseWork.studentSubmissions.modifyAttachments 提出要求，在學生提交的內容中加入附件，例如 Google 雲端硬碟檔案或 link Material，指向學生在您網站上的作業。
8. 您也可以向 courses.courseWork.studentSubmissions.patch 發出要求，設定學生的作業成績。

圖 1. 使用 CourseWork 整合功能建立的 link Material 作業，在編輯作業時顯示的師生檢查畫面。

您也可以呼叫 courses.announcements.create 或 courses.courseWorkMaterials.create 來建立公告或課程教材，而非作業。如需相關 Classroom API 動作的詳細說明，請參閱「建立及管理課程作業」和「設定及更新成績」頁面。

注意事項

請先考量以下事項，再決定是否要為產品需求採用 CourseWork 整合功能。

• 您必須授權使用者，並提示他們同意。您代表使用者提出 API 要求。舉例來說，您無法在「任何」Google Classroom 課程中建立課程作業，只能在授權使用者教導的課程中建立課程作業。
• 您需要提供使用者選取課程的方式，以便他們接收內容。 建議使用 courses.list 取得使用者教授的課程清單，然後允許使用者從清單中選取一或多門課程。
• 使用者在 Classroom 中按一下 link Material 時，連結會在新分頁中開啟。開啟網址時，您的伺服器不會收到任何 Classroom 資訊。
• 老師可以自行修改或刪除課程，不必透過開發人員。這表示開發人員對課程的瞭解可能會過時。如果您需要瞭解課程異動情形，建議您設定推播通知，以便掌握課程異動情形。
• 老師可以在 Classroom 使用介面中，使用網站網址的貼上連結來建立課程。以這種方式建立的課程由老師單獨擁有，因此您無法使用 Classroom API 查看、修改或設定提交成績。