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

スプレッドシート - Batch Get タスク

スプレッドシート - Batch Get タスクを使用すると、Google スプレッドシートから複数の不連続な値の範囲を読み取り、取得できます。

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

始める前に

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

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

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

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

タスク入力パラメータ

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

プロパティ	データ型	説明
SpreadsheetId	文字列	スプレッドシートの ID。スプレッドシートの ID はウェブ URL で確認できます。例: `https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0`
MajorDimension	enum (Dimension)	適用するメインカテゴリまたはディメンション。たとえば、`ROWS` や `COLUMNS` です。デフォルト値: `DIMENSION_UNSPECIFIED`
範囲	文字列	値を取得する範囲の A1 表記または R1C1 表記。
DateTimeRenderOption	enum (DateTimeRenderOption)	日付、時刻、期間に関連する値が出力でどのように表されるかを示します。注: dateTimeRenderOption は、valueRenderOption に指定された値が `FORMATTED_VALUE` の場合には考慮されません。デフォルト値: `SERIAL_NUMBER`
ValueRenderOption	enum (ValueRenderOption)	取得した値が出力でどのように表されるかを示します。デフォルト値: `FORMATTED_VALUE`

タスク出力

スプレッドシート - バッチ取得タスクは、スプレッドシート ID を持つオブジェクトと、リクエストされた順番に対応する各リクエスト範囲に対応する ValueRange オブジェクトの配列を含むレスポンス出力を返します。出力例を次に示します。

{
        "spreadsheetId": SPREADSHEET_ID,
        "valueRanges": [
          {
            "range": "Sheet1!B1:B1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Cost",20.5,15,100,135.5]
            ]
          },
          {
            "range": "Sheet1!D1:D1000",
            "majorDimension": "COLUMNS",
            "values": [
              ["Ship Date",42430,42444,42449,42449]
            ]
          }
        ]
      }

エラー処理方法

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

次のステップ

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