Google 試算表 - 取得工作

「Google 試算表 - 取得」工作可讓您讀取及擷取 Google 試算表中的單一值範圍。

Google 試算表是 Google Workspace 中眾多雲端效率解決方案之一。您可以使用這項工具建立及編輯線上試算表，並即時與他人協作。

事前準備

請務必先在 Google Cloud 專案中執行下列工作，再設定「Google 試算表 - 取得」工作：

啟用 Google Sheets API (sheets.googleapis.com)。
啟用 Google Sheets API
建立類型為「服務帳戶」的驗證設定檔。Application Integration 會使用驗證設定檔 (服務帳戶) 連線至 Google 試算表 - 取得工作的驗證端點。
如要瞭解如何授予服務帳戶其他角色或權限，請參閱「授予、變更及撤銷存取權」。
在 Google 試算表中，授予服務帳戶存取試算表的權限。
瞭解 Google 試算表使用的常見術語。

設定「Google 試算表 - 取得」工作

前往 Google Cloud 控制台的「Application Integration」頁面。
前往「Application Integration」
在導覽選單中，按一下「整合」。
系統隨即會顯示「整合」頁面，列出 Google Cloud 專案中可用的所有整合功能。
選取現有整合，或按一下「建立整合」建立新整合。
如要建立新的整合項目：
1. 在「建立整合」窗格中輸入名稱和說明。
2. 選取整合作業的區域。
  注意：「區域」下拉式選單只會列出 Google Cloud 專案中佈建的區域。如要佈建新區域，請按一下「啟用區域」。詳情請參閱「啟用新區域」。
3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料，請隨時前往整合工具列的「整合摘要」窗格。
  注意：只有在您為所選區域啟用整合控管功能時，系統才會顯示選取服務帳戶的選項。
4. 按一下「建立」，新建立的整合服務會在整合服務編輯器中開啟。
在整合編輯器的導覽列中，按一下「Tasks」(工作)，即可查看可用工作和連結器的清單。
在整合服務編輯器中，按一下並放置「Sheets - Get」(試算表 - 取得) 元素。
按一下設計工具中的「Sheets - Get」(試算表 - 取得) 元素，即可查看「Sheets - Get」(試算表 - 取得) 任務設定窗格。
前往「驗證」，然後選取要使用的現有驗證設定檔。
(選用步驟) 如果您尚未建立驗證設定檔，請在設定工作前按一下「+ 新增驗證設定檔」，然後按照「建立新的驗證設定檔」一文中的步驟操作。
前往「Task Input」(任務輸入內容)，然後使用下列「Task input parameters」(任務輸入參數) 表格，設定顯示的輸入欄位。
系統會自動儲存輸入欄位的變更。

工作輸入參數

下表說明「Sheets - Get」(Google 試算表 - 取得) 工作的輸入參數：

資源	資料類型	說明
SpreadsheetId	字串	試算表的 ID。您可以從試算表的網頁網址中找到 ID。例如：`https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0`
MajorDimension	enum (Dimension)	應套用的主要類別或維度。例如 `ROWS` 或 `COLUMNS`。預設值： `DIMENSION_UNSPECIFIED`
範圍	字串	要從中擷取值的範圍的A1 標示法或 R1C1 標示法。
dateTimeRenderOption	enum (DateTimeRenderOption)	指出輸出內容中日期、時間和時長相關值的表示方式。注意：如果為 valueRenderOption 指定的值是 `FORMATTED_VALUE`，系統就不會考慮 dateTimeRenderOption。預設值： `SERIAL_NUMBER`
ValueRenderOption	enum (ValueRenderOption)	指出擷取的值在輸出內容中的表示方式。預設值： `FORMATTED_VALUE`

工作輸出

「Google 試算表 - 取得」工作會傳回回應輸出內容，其中包含對應於所要求範圍的 ValueRange 物件。以下是輸出範例：

    {
        "range": "Sheet1!A1:D5",
        "majorDimension": "ROWS",
        "values": [
          ["Item", "Cost", "Stocked", "Ship Date"],
          ["Wheel", "$20.50", "4", "42430"],
          ["Door", "$15", "2", "42444"],
          ["Engine", "$100", "1", "42449"],
          ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
        ],
      }

錯誤處理策略

工作錯誤處理策略會指定工作因暫時性錯誤而失敗時，系統應採取的動作。如要瞭解如何使用錯誤處理策略，以及不同類型的錯誤處理策略，請參閱「錯誤處理策略」。

配額與限制

如要瞭解配額和限制，請參閱配額和限制。