Application Integration でサポートされているコネクタをご覧ください。

スプレッドシート - Append タスク

スプレッドシート - 追加 タスクを使用すると、Google スプレッドシート内の指定したデータのテーブルの後にデータを追加できます。新しい値は、テーブルの先頭列から、指定したテーブルの後に作成される新しい行に追加されます。

Google スプレッドシートは Google Workspace の多くのクラウドベースの生産性向上ソリューションの一つです。リアルタイムの共同編集機能を使用して、オンラインスプレッドシートの作成と編集を行うことができます。

始める前に

スプレッドシート - Append タスクを構成する前に、Google Cloud プロジェクトで次のタスクを行う必要があります。

Google Sheets API（sheets.googleapis.com）を有効にします。
Google Sheets API を有効にする
認証プロファイルを作成します。Application Integration では、認証プロファイルを使用して、スプレッドシート - 追加タスクの認証エンドポイントに接続します。
サービスアカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。
Google スプレッドシートで使用されている一般的な用語を理解し、学習します。

スプレッドシートの設定 - タスクを追加

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。
新しい統合を作成する場合:
1. [統合の作成] ペインで名前と説明を入力します。
2. 統合のリージョンを選択します。
  注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
3. 統合用のサービスアカウントを選択します。統合のサービスアカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
  注: サービスアカウントを選択するオプションは、選択したリージョンで統合ガバナンスを有効にしている場合にのみ表示されます。
4. [作成] をクリックします。
統合デザイナーで統合が開きます。
統合エディタのナビゲーションバーで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
統合エディタで、[Sheets - Append] 要素をクリックして配置します。
デザイナーで [Sheets - Append] 要素をクリックして、[Sheets - Append] タスク構成ペインを表示します。
[Authentication] に移動し、使用する既存の認証プロファイルを選択します。
省略可。タスクを構成する前に認証プロファイルを作成していない場合は、[+ New authentication profile] をクリックし、新しい認証プロファイルを作成するに記載されている手順に沿って操作します。
[Task Input] に移動し、次の「タスクの入力パラメータ」の表を使用して表示される入力フィールドを構成します。
入力フィールドの変更は自動的に保存されます。

タスクの入力パラメータ

次の表に、スプレッドシート - Append タスクの入力パラメータを示します。

プロパティ	データ型	説明
SpreadsheetId	文字列	スプレッドシートの ID。スプレッドシートの ID はウェブ URL で確認できます。例: `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)	日付、時刻、期間に関連する値が出力でどのように表されるかを示します。注: dateTimeRenderOption は、valueRenderOption に指定された値が `FORMATTED_VALUE` の場合には考慮されません。デフォルト値: `SERIAL_NUMBER`
ResponseValueRenderOption	enum (ValueRenderOption)	取得した値が出力でどのように表されるかを示します。デフォルト値: `FORMATTED_VALUE`
リクエスト	JSON	リクエストの本文は、書き込む範囲の値を記述する ValueRange オブジェクトです。リクエスト JSON 構造をご覧ください。

タスク出力

スプレッドシート - Append タスクは、次のサンプル出力のように、AppendValuesResponse オブジェクトを含むレスポンス出力を返します。

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

エラー処理方法

タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式の使用方法と、さまざまな種類のエラー処理方式の詳細については、エラー処理の方式をご覧ください。

次のステップ

エッジとエッジの条件を追加する。
インテグレーションをテストして公開する。
トリガーを構成する。
データマッピングタスクを追加する。
Google Cloud サービス向けのすべてのタスクを確認する。