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 驗證,請務必授予服務帳戶適當的權限。詳情請參閱「身分與存取權管理角色和權限」。

設定連接器

連線專屬於資料來源。也就是說,如果您有多個資料來源,則必須為每個資料來源建立個別的連線。如要建立連線,請按照下列步驟操作:

  1. Cloud 控制台中,前往「Integration Connectors」>「Connections」頁面,然後選取或建立 Google Cloud 專案。

    前往「連線」頁面

  2. 按一下「+ 建立新項目」開啟「建立連線」頁面。
  3. 在「位置」部分中,選擇連線位置。
    1. 區域:從下拉式清單中選取位置。

      如需所有支援的地區清單,請參閱「位置」一文。

    2. 點選「下一步」
  • 在「連線詳細資料」部分,設定下列欄位:
    1. 連接器:從可用連接器的下拉式清單中選取「Google Classroom」
    2. 連接器版本:從可用版本的下拉式清單中選取連接器版本。
    3. 在「連線名稱」欄位中,輸入連線執行個體的名稱。

      連線名稱必須符合下列條件:

      • 連線名稱可使用英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱開頭須為英文字母,結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個字元。
    4. 視需要輸入連線執行個體的「Description」(說明)
    5. 如要記錄連接器執行詳細資料,請選取「啟用雲端記錄」
    6. 服務帳戶:選取具備必要角色的服務帳戶。
    7. 視需要設定「連線節點設定」

      • 節點數量下限:輸入連線節點數量下限。
      • 節點數量上限:輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多,就需要越多節點;反之,處理的交易量越少,需要的節點就越少。如要瞭解節點對連接器定價的影響,請參閱「 連線節點定價」。如未輸入任何值,系統預設會將節點下限設為 2 (提高可用性),節點上限則設為 50。

    8. (選用) 按一下「+ 新增標籤」,以鍵/值組合的形式為連結新增標籤。
    9. 點選「下一步」
    10. 在「Authentication」(驗證) 部分中,輸入驗證詳細資料。
      1. 選取「驗證類型」並輸入相關詳細資料。

        您可以選擇下列任一驗證類型:

        • OAuth 2.0 - 授權碼
      2. 如要瞭解如何設定這些驗證類型,請參閱「設定驗證」。

      3. 點選「下一步」
    11. 檢查:檢查連線和驗證詳細資料。
    12. 點選「建立」

    設定驗證機制

    根據要使用的驗證方式輸入詳細資料。

    • 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 中使用。您可以在整合中透過「連接器」工作使用連線。

    向 Google Cloud 社群尋求協助

    如要發布問題及討論這個連接器,請前往 Cloud 論壇的 Google Cloud 社群。

    後續步驟