Skip to main content

連結至 Google Sheets

開始之前

在開始之前,請先了解如何創建資料來源

Step1: 啟用 Google Sheets API#

請至 Google Sheets API 頁面,在您欲使用的專案 (Project) 中啟動 API

enable_gsheet_api

Step2: 準備服務帳號 (Service Account)#

CannerFlow 使用 服務帳號 (Service Account) 的 Authentication 方式操作 Google Cloud APIs,故需準備 服務帳號 (Service Account)

請參考 Google Cloud Authenticating as a service account > Creating a service account 部分

  1. 到 Google Cloud Create Service Account 頁面
  2. 選擇專案
  3. 開始建立服務帳號 (Service Account),輸入像以下的資訊 gsheet_create_sa
  4. 跳過第二跟第三步驟,直接點選完成,接著會回到列表畫面,點選剛剛創建的服務帳號 gsheet_sa_info
  5. 點選 金鑰,點擊 新增金鑰,選擇 JSON 類型 gsheet_download_sa_json
  6. 下載後的 JSON 內容會如下 gsheet_sa_json

Step3: 授權 Google Sheet 給 Service Account#

  1. 請到上個步驟建立的服務帳號 (Service Account) 頁面,並複製電子郵件地址gsheet_sa_info
  2. 到欲連結到 CannerFlow 的 Google Sheet 中,點選共用,並貼上電子郵件地址,新增為新的使用者,並給予檢視者的角色 gsheet_auth_sa
  3. 設定完成,會如下圖,多一個 Service Account 的使用者 gsheet_auth_sa_done

Step4: 回到 CannerFlow 畫面,並移動至 Data Sources 頁面#

請點擊側欄的 Data Sources 至資料來源設定頁面

nav_to_data_source

Step5: 創建資料來源#

點擊右上方的 Create a Data Source,設定以下資訊在彈出表單中

  • Name: 資料庫名稱,供顯示使用,後續可作修改
  • Data Source Type: 資料庫類型,請選擇 Google Sheet
  • Google Sheet ID: 請填入 Google Sheet 的 Spreadsheet ID
取得 Google Sheet 的 Spreadsheet ID

請在 Google Sheet 的網址中,複製下圖中紅框起來的 URL 片段 gsheet_sheet_id

  • Encoded Credentials: Service Account 的金鑰內容
如何填入 Service Account 的金鑰內容
  1. 點擊該 input 右邊的鉛筆 Icon connect_gsheet_click_convert
  2. 在跳出的視窗中貼上,Step2 中 JSON 的內容後,點擊 Convert,就可回到表單繼續完成其他欄位的填寫 connect_gsheet_convert_form_with_json

connect_gsheet_form

Submit 後,稍後片刻會跳回列表頁面,並可看到 Google Sheet 的資料來源在列表中

Step6: 探索資料來源的 Metadata#

Google Sheet 的資料來源上點擊 放大鏡 的 Icon,並在下拉選單中可看到 CannerFlow 探索出來的 Table,選擇 Table 後,可看到該 Table 的 Column 資訊

explore_gsheet

後續使用#

接下來,就可在 Workspace 中選擇資料來源中的 Table,請參考 工作區內 Table 管理