Google Classroom
您可以使用 Google Classroom 連接器,在 Google Classroom 中執行支援的作業。
事前準備
使用 Google Classroom 連接器前,請先完成下列工作:
- 在 Google Cloud 專案中:
- 確認已設定網路連線。如要瞭解網路模式,請參閱「網路連線」。
- 將 roles/connectors.admin IAM 角色授予設定連線器的使用者。
- 將下列 IAM 角色授予要用於連接器的服務帳戶:
roles/secretmanager.viewer
roles/secretmanager.secretAccessor
服務帳戶是特殊的 Google 帳戶類型,主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。如果您沒有服務帳戶,請建立服務帳戶。詳情請參閱「建立服務帳戶」。
- 啟用下列服務:
secretmanager.googleapis.com
(Secret Manager API)connectors.googleapis.com
(Connectors API)
如要瞭解如何啟用服務,請參閱「啟用服務」。
如果專案先前未啟用這些服務或權限,系統會在設定連結器時提示您啟用。
- 如果您使用服務帳戶驗證,而非 OAuth 2.0 驗證,請務必授予服務帳戶適當的權限。詳情請參閱「身分與存取權管理角色和權限」。
設定連接器
連線專屬於資料來源。也就是說,如果您有多個資料來源,則必須為每個資料來源建立個別的連線。如要建立連線,請按照下列步驟操作:
- 在 Cloud 控制台中,前往「Integration Connectors」>「Connections」頁面,然後選取或建立 Google Cloud 專案。
- 按一下「+ 建立新項目」開啟「建立連線」頁面。
- 在「位置」部分中,選擇連線位置。
- 區域:從下拉式清單中選取位置。
如需所有支援的地區清單,請參閱「位置」一文。
- 點選「下一步」。
- 區域:從下拉式清單中選取位置。
- 連接器:從可用連接器的下拉式清單中選取「Google Classroom」。
- 連接器版本:從可用版本的下拉式清單中選取連接器版本。
- 在「連線名稱」欄位中,輸入連線執行個體的名稱。
連線名稱必須符合下列條件:
- 連線名稱可使用英文字母、數字或連字號。
- 字母必須為小寫。
- 連線名稱開頭須為英文字母,結尾則須為英文字母或數字。
- 連結名稱不得超過 49 個字元。
- 視需要輸入連線執行個體的「Description」(說明)。
- 如要記錄連接器執行詳細資料,請選取「啟用雲端記錄」。
- 服務帳戶:選取具備必要角色的服務帳戶。
- 視需要設定「連線節點設定」:
- 節點數量下限:輸入連線節點數量下限。
- 節點數量上限:輸入連線節點數量上限。
節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多,就需要越多節點;反之,處理的交易量越少,需要的節點就越少。如要瞭解節點對連接器定價的影響,請參閱「 連線節點定價」。如未輸入任何值,系統預設會將節點下限設為 2 (提高可用性),節點上限則設為 50。
- (選用) 按一下「+ 新增標籤」,以鍵/值組合的形式為連結新增標籤。
- 點選「下一步」。
-
在「Authentication」(驗證) 部分中,輸入驗證詳細資料。
- 選取「驗證類型」並輸入相關詳細資料。
您可以選擇下列任一驗證類型:
- OAuth 2.0 - 授權碼
- 點選「下一步」。
如要瞭解如何設定這些驗證類型,請參閱「設定驗證」。
- 選取「驗證類型」並輸入相關詳細資料。
- 檢查:檢查連線和驗證詳細資料。
- 點選「建立」。
設定驗證機制
根據要使用的驗證方式輸入詳細資料。
- OAuth 2.0 - 授權碼
- 用戶端 ID:連線至後端 Google 服務時所需的用戶端 ID。
- 範圍:從下拉式選單中選取所需的 OAuth 2.0 範圍。如要查看所需 Google 服務支援的所有 OAuth 2.0 範圍,請參閱「Google API 適用的 OAuth 2.0 範圍」頁面中的相關章節。
- 用戶端密鑰:選取 Secret Manager 密鑰,內含與用戶端密鑰相關聯的密碼。
- 密鑰版本:選取密鑰版本。
動作
這個連接器會為所連後端服務的物件提供抽象層。您只能透過這個抽象層存取後端的物件。您會看到這些抽象概念以動作的形式呈現。Action
是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體,並因連接器而異。不過,連接器可能不支援任何動作,此時 Actions
清單就會空白。
在整合服務中使用 Google Classroom 連線
建立連線後,即可在 Application Integration 中使用。您可以在整合中透過「連接器」工作使用連線。