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

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

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

始める前に

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

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

スプレッドシートを構成する - タスクを追加する

Apigee UI で、Apigee 組織を選択します。
[Develop] > [Integrations] の順にクリックします。
既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。
新しいインテグレーションを作成する場合:
1. [Create Integration] ダイアログで名前と説明を入力します。
2. サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
3. [Create] をクリックします。
インテグレーションデザイナーでインテグレーションが開きます。
統合デザイナーのナビゲーションバーで、[+ Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
統合デザイナーで、[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 サービス向けのすべてのタスクを確認する。