Google 試算表 - 附加工作

使用「試算表 - 附加」工作，即可在 Google 試算表中的指定資料表後方附加資料。新值會附加至指定資料表後方建立的新資料列，並從資料表的第一欄開始。

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

事前準備

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

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

設定「Google 試算表 - 附加」工作

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

工作輸入參數

下表說明「Google 試算表 - 附加」工作輸入參數：

資源	資料類型	說明
SpreadsheetId	字串	試算表的 ID。您可以從試算表的網頁網址中找到 ID。例如：`https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0`
範圍	字串	要搜尋工作表中所需表格的範圍 A1 標記。
IncludeValuesInResponse	Boolean	指出傳回的物件是否應包含附加值的儲存格值。
InsertDataOption	enum (InsertDataOption)	指出附加新資料時，現有資料的變更方式。
ValueInputOption	enum (ValueInputOption)	指出資料的解讀方式。預設值： `INPUT_VALUE_OPTION_UNSPECIFIED`
ResponseDateTimeRenderOption	enum (DateTimeRenderOption)	指出輸出內容中日期、時間和時長相關值的表示方式。注意：如果為 valueRenderOption 指定的值是 `FORMATTED_VALUE`，系統就不會考慮 dateTimeRenderOption。預設值： `SERIAL_NUMBER`
ResponseValueRenderOption	enum (ValueRenderOption)	指出擷取的值在輸出內容中的表示方式。預設值： `FORMATTED_VALUE`
要求	JSON	要求主體是 ValueRange 物件，用於說明要寫入的範圍值。請參閱要求 JSON 結構。

工作輸出

「Google 試算表 - 附加」工作會傳回包含 AppendValuesResponse 物件的回應輸出內容，類似於下列範例輸出內容：

    {
        "spreadsheetId": SPREADSHEET_ID,
        "tableRange": "Sheet1!A1:D2",
        "updates": {
          "spreadsheetId": SPREADSHEET_ID,
          "updatedRange": "Sheet1!A3:D4",
          "updatedRows": 2,
          "updatedColumns": 4,
          "updatedCells": 8,
        }
      }

錯誤處理策略

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

配額與限制

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