查看 Application Integration 支援的連接器。

試算表 - 附加工作

試算表 - 附加工作可讓您在 Google 試算表中，在指定資料表的後方附加資料。新值會附加至指定資料表後方新建立的資料列，從資料表的第一個資料欄開始。

Google 試算表是 Google Workspace 中眾多雲端式效率提升解決方案之一。你可以使用這項功能建立及編輯線上試算表，並即時協作。

事前準備

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

  1. 啟用 Google 試算表 API (sheets.googleapis.com)。

    啟用 Google Sheets API

  2. 建立驗證設定檔。Application Integration 會使用驗證設定檔，連線至「試算表 - 附加」工作流程的驗證端點。

    如要進一步瞭解如何為服務帳戶授予其他角色或權限，請參閱「授予、變更及撤銷存取權」一文。

  3. 瞭解 Google 試算表中使用的常見術語。

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

  1. 前往 Google Cloud 控制台的「Application Integration」頁面。

    前往「應用程式整合」

  2. 在導覽選單中，按一下「整合」。

    系統隨即會顯示「Integrations」頁面，列出 Google Cloud 專案中可用的所有整合項目。

  3. 選取現有的整合，或按一下「建立整合」來建立新的整合。

    如果您要建立新的整合功能：

    1. 在「Create Integration」窗格中輸入名稱和說明。
    2. 選取整合作業的區域。
    3. 選取要用於整合的服務帳戶。您隨時可以透過整合工具列的 「整合摘要」窗格，變更或更新整合作業的服務帳戶詳細資料。
    4. 按一下「建立」，新建立的整合服務會在整合服務編輯器中開啟。

  4. 在整合編輯器的導覽列中，按一下「Tasks」，即可查看可用任務和連接器的清單。
  5. 在整合服務編輯器中，按一下並放置「Sheets - Append」元素。
  6. 在設計工具中，按一下「Sheets - Append」元素，即可查看「Sheets - Append」任務設定窗格。
  7. 前往「驗證」，然後選取要使用的現有驗證設定檔。

    (非必要) 如果您在設定工作前尚未建立驗證設定檔，請按一下「+ 新驗證設定檔」，然後按照「建立新的驗證設定檔」一節所述的步驟操作。

  8. 前往「Task Input」，然後使用下列「Task input parameters」表格設定顯示的輸入欄位。

    系統會自動儲存輸入欄位的變更。

工作輸入參數

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

資源 資料類型 說明
SpreadsheetId 字串 試算表的 ID。

你可以透過試算表的網址找到 ID。例如：https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0

範圍 字串 範圍的 A1 符號，用於在工作表中搜尋所需表格。
IncludeValuesInResponse 布林值 指出傳回的物件是否應包含附加值的儲存格值。
InsertDataOption enum (InsertDataOption) 指出在附加新資料時，現有資料會如何變更。
ValueInputOption enum (ValueInputOption) 指出資料的解讀方式。

預設值： INPUT_VALUE_OPTION_UNSPECIFIED

ResponseDateTimeRenderOption enum (DateTimeRenderOption) 指示如何在輸出內容中呈現日期、時間和時間長度相關的值。

預設值： SERIAL_NUMBER

ResponseValueRenderOption enum (ValueRenderOption) 指示擷取的值在輸出內容中的呈現方式。

預設值： FORMATTED_VALUE

要求JSON 要求主體是 ValueRange 物件，用於描述要寫入的範圍值。請參閱「要求 JSON 結構」。

任務輸出

「Sheets - Append」任務會傳回包含 AppendValuesResponse 物件的回應輸出內容，類似於下列範例輸出內容：

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

錯誤處理策略

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

配額與限制

如要進一步瞭解配額和限制，請參閱「配額與限制」。

後續步驟