常見問題

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

我可以在 Classroom API 中使用 CourseWork 端點建構什麼內容?

新端點可讓開發人員查看及管理類別中的作業。具體而言 您可以執行下列所有操作:

  • 查看作業和問題 (統稱為「CourseWork」) 使用者
  • 建立、修改及刪除CourseWork
  • 附加資料 (雲端硬碟檔案、YouTube 影片、連結) 至 CourseWork
  • 變更學生繳交作業的狀態 (例如繳交、發還、 收回)
  • 為繳交作業設定成績
  • 附加資料 (雲端硬碟檔案、YouTube 影片、連結) 至 學生繳交的作業

CourseWork 的部分用途範例:

  • 成績單、學生資訊系統或報告系統可以同步處理下列來源的作業和成績 從 Classroom 導入應用程式,省去人工作業的麻煩 轉乘
  • 學習應用程式可以建立顯示在課程中的新作業 串流。學生完成作業後,應用程式就能繳交作業, 批改、附加學生作業及合適的儲存作業 雲端硬碟資料夾。
  • 老師使用者可以從以下項目建立含有外掛程式附件的作業 網站或應用程式
  • 學生使用者可以繳交含有外掛程式的作業 附件。

我的應用程式需要哪些權限,才能建立或修改指派?

一般而言,應用程式只能修改自身建立的工作。也就是 所有指派的異動 API 要求都必須使用 儲存於建立作業時儲存。

Google Classroom 外掛程式不受這項規則限制。A 罩杯 Cloud 專案可以存取或修改任何公告、作業或 附件含有一或多個外掛程式附件的內容。A 罩杯 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 產品資訊。安裝中 隨後,即可安裝以下 SDK 套件中的「所有」外掛程式 一次。使用者需要取得隨附外掛程式所需的所有範圍同意 。

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

否,Google Cloud 專案的 OAuth 用戶端 無法使用 Classroom 外掛程式 Google Cloud 專案。存取權杖 因其他 Google Cloud 專案而產生訊息,就會遭到 Classroom API 拒絕。 您必須為外掛程式專案建立獨立的 OAuth 用戶端。

使用者體驗

我們的標誌無法容納在小型正方形中。iframe 標題列中是否有標誌大小選項?

iframe 標題列僅支援 32x32 正方形標誌。這個 配合公司網站使用的網站小圖示形狀 我們的指引是在空間中使用相同的標誌,維持品牌一致性。

網域

同一網域中的所有老師和學生是否都能存取已安裝的外掛程式?

學校管理員可以控管哪些老師可以查看 安裝的外掛程式只有使用者才能使用 Classroom 外掛程式 提供教學學習或 Education Plus 授權。

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

網域管理員 (管理員) 會控管哪些使用者能使用外掛程式。他們可以 透過管理員安裝程序,為整個網域安裝外掛程式 選項。如果外掛程式可以個別安裝 管理員保有外掛程式許可清單。您可以為老師安裝 再向大家介紹管理員也可能選擇 個別安裝您的外掛程式,以進行測試。

管理員可能也會想瞭解 外掛程式。如果產品支援這項功能,建議您提供使用情況統計資料 自訂預測功能

API

要得知合作夥伴頁面是載入到 iframe 或彈出式分頁中,下列哪一項是可靠的方法?

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

哪些可指派的作業項目會有學生作業回顧 iframe?

學生作業檢閱 iframe 只會用於活動類型附件。 呼叫 courses.courseWork.getAddOnContext 方法,查看是否張貼 類型支持學生作業supportsStudentWork 欄位只能是 true 屬於活動的文章類型。

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

可以。您可以getpatch任何 AnnouncementCourseWorkCourseWorkMaterial 含有至少一個外掛程式附件。 您可以reclaimreturn,或turnIn CourseWork StudentSubmission

單一登入

可以,他們仍可使用 Google 登入。

即使學生無法登入 Gmail,所有學生還是具備格式正確的電子郵件地址?

所有的 Google Workspace for Education 使用者都有 Google 身分, 使用。以電子郵件地址表示身分 讓我們看看 DNS 解析 進一步探索內部和外部位址任何特定 Google 服務 (包括 Gmail) 的身分與存取權 不同之處。因此,即使停用 Gmail,學生使用者 他們的電子郵件地址。

學校管理員是否需要預先核准應用程式,學生才能登入?

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

意見回饋與一般問題

如何提交功能要求或要求問題?

您可以在公開問題中提交、查看功能要求,以及參與投票 追蹤器

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

如要瞭解 API 更新,請前往版本資訊網頁,也就是我們的開發人員論壇公開 Issue Tracker

我使用的是 Classroom API,如何詢問技術問題?

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