總覽

軟體開發人員、管理員和學校領導人可透過 Google Classroom API 程式介面管理 Google Classroom 資源。您可以建構軟體，建立、擷取及修改 Classroom 課程和內容。

常見的用途包括：

  • 管理課程、學生名單和監護人
  • 新增作業、公告和課程教材
  • 指派成績及修改評分設定
  • 產生用於分析的資料
  • 讓外部供應商提供的內容或工具可在 Classroom 中探索及存取

Classroom API 是否適合我？

Google 提供多種產品，協助您與 Classroom 互動。以下是一些常見情境，以及可能最符合您需求的產品建議。

修改 Google Classroom 資源

情境 推薦的解決方案
我想定期管理大量課程、使用者或其他 Classroom 資源。我擅長編寫程式碼及維護軟體基礎架構。 編寫使用 Classroom API 的應用程式。
我偶爾需要管理少量的 Classroom 資源。我能輕鬆編寫少量程式碼，且負擔不大。 搭配 Google Apps Script 使用 Classroom API。
我想偶爾變更個別 Classroom 資源。我熟悉終端機指令。 使用 Google Apps Manager。
我想要大量報表，其中包含 Classroom 中事件的詳細資料。 使用 BigQuery 資料移轉服務。
我想調查使用者的活動。 在管理控制台中產生報表，或使用 Reports API。

與 Google Classroom 整合

情境 推薦的解決方案
我希望老師和學生在 Classroom 中查看及啟動我的內容。 建立 Classroom 外掛程式。
我希望老師點選網站或應用程式上的按鈕，將我的內容嵌入 Classroom。 建構 Classroom 外掛程式，並以程式輔助方式建立附件。
我希望老師點選網站或應用程式上的按鈕，即可連結至 Classroom 中的內容。 使用 Classroom API 建立課程作業，或嵌入「分享到 Classroom」按鈕。
我希望 Classroom 老師能同步處理或匯入學生資訊系統的資訊。 實作 OneRoster for SIS，或使用 Classroom API 建立及存取資源。

開始使用

建議新開發人員在開始新專案前，先執行下列操作：

如要開始開發，請確認您已完成必要步驟。根據需求選擇適當的 Classroom API 範圍，然後設定環境，並按照其中一個快速入門導覽課程開始提出要求：

使用 Google APIs Explorer 進行實驗

如要實驗呼叫即時資料的方法，請試用 Google APIs Explorer。您不必編寫任何程式碼即可開始使用，但請注意，使用 APIs Explorer 執行的動作可能會修改現有資料。

如要開始呼叫方法，其中一種方式是呼叫 courses.list() 方法。這個方法不需要任何要求參數，您可以從傳回的課程清單中擷取 id，做為其他 API 呼叫的要求參數。如果沒有任何課程，可以使用 courses.create() 方法建立課程。

您也可以瀏覽 Classroom API 參考資料。