スプレッドシート - 取得タスクを使用すると、Google スプレッドシートから単一範囲の値を読み取り、取得できます。
Google スプレッドシートは Google Workspace の多くのクラウドベースの生産性向上ソリューションの一つです。リアルタイムの共同編集機能を使用して、オンライン スプレッドシートの作成と編集を行うことができます。
始める前に
スプレッドシート - 取得タスクを構成する前に、Google Cloud プロジェクトで次のタスクを行う必要があります。
- Google Sheets API（
sheets.googleapis.com）を有効にします。 -
認証プロファイルを作成します。Apigee Integration では、認証プロファイルを使用して、スプレッドシート - 取得タスクの認証エンドポイントに接続します。
サービス アカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。
- Google スプレッドシートで使用されている一般的な用語を理解し、学習します。
スプレッドシート - 取得タスクを構成する
- Apigee UI で、Apigee 組織を選択します。
- [Develop] > [Integrations] の順にクリックします。
- 既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。
新しいインテグレーションを作成する場合:
- [Create Integration] ダイアログで名前と説明を入力します。
- サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
- [Create] をクリックします。
インテグレーション デザイナーでインテグレーションが開きます。
- 統合デザイナーのナビゲーション バーで、[+ +Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
- 統合デザイナーで、[Sheets - Get] 要素をクリックして配置します。
- デザイナーで [Sheets - Get] 要素をクリックして、[Sheets - Get] タスク構成ペインを表示します。
- [Authentication] に移動し、使用する既存の認証プロファイルを選択します。
省略可。タスクを構成する前に認証プロファイルを作成していない場合は、[+ New authentication profile] をクリックし、新しい認証プロファイルを作成するに記載されている手順に沿って操作します。
- [Task Input] に移動し、次の「タスクの入力パラメータ」の表を使用して表示される入力フィールドを構成します。
入力フィールドの変更は自動的に保存されます。
タスクの入力パラメータ
次の表に、スプレッドシート - 取得タスクの入力パラメータを示します。
| プロパティ | データ型 | 説明 |
|---|---|---|
| SpreadsheetId | 文字列 | スプレッドシートの ID。 スプレッドシートの ID はウェブ URL で確認できます。例: |
| MajorDimension | enum (Dimension) | 適用するメインカテゴリまたはディメンション。たとえば、ROWS や COLUMNS です。デフォルト値: |
| 範囲 | 文字列 | 値を取得する範囲の A1 表記または R1C1 表記。 |
| dateTimeRenderOption | enum (DateTimeRenderOption) | 日付、時刻、期間に関連する値が出力でどのように表されるかを示します。
デフォルト値: |
| ValueRenderOption | enum (ValueRenderOption) | 取得した値が出力でどのように表されるかを示します。 デフォルト値: |
タスク出力
スプレッドシート - 取得タスクは、リクエストされた範囲に対応する 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)"]
],
}
エラー処理方法
タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式の使用方法と、さまざまな種類のエラー処理方式の詳細については、エラー処理の方式をご覧ください。
次のステップ
- エッジとエッジの条件を追加する。
- インテグレーションをテストして公開する。
- トリガーを構成する。
- データ マッピング タスクを追加する。
- Google Cloud サービス向けのすべてのタスクを確認する。