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

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

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

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

準備

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

  1. Google Sheets API（sheets.googleapis.com）を有効にします。

    Google Sheets API を有効にする

  2. 認証プロファイルを作成します。Application Integration では、認証プロファイルを使用して、スプレッドシート - Batch Get タスクの認証エンドポイントに接続します。

    サービス アカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。

  3. Google スプレッドシートで使用されている一般的な用語を理解し、学習します。

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

  1. Google Cloud コンソールで [Application Integration] ページに移動します。

    Application Integration に移動

  2. ナビゲーション メニューで [統合] をクリックします。

    [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

  3. 既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。

    新しい統合を作成する場合:

    1. [統合の作成] ペインで名前と説明を入力します。
    2. 統合のリージョンを選択します。
    3. 統合用のサービス アカウントを選択します。統合のサービス アカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
    4. [作成] をクリックします。

    統合エディタで統合が開きます。

  4. 統合エディタのナビゲーション バーで、[タスク] をクリックして、使用可能なタスクとコネクタのリストを表示します。
  5. 統合エディタで、[Sheets - Batch Get] 要素をクリックして配置します。
  6. デザイナーの [スプレッドシート - バッチ取得] 要素をクリックして、[スプレッドシート - バッチ取得] タスク構成ペインを表示します。
  7. [認証] に移動し、使用する既存の認証プロファイルを選択します。

    省略可。タスクを構成する前に認証プロファイルを作成していない場合は、[+ 新しい認証プロファイル] をクリックし、新しい認証プロファイルを作成するに記載されている手順に沿って操作します。

  8. [Task Input] に移動し、次の [タスク入力パラメータ] テーブルを使用して表示される入力フィールドを構成します。

    入力フィールドの変更は自動的に保存されます。

タスク入力パラメータ

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

プロパティ データ型 説明
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) 日付、時刻、期間に関連する値が出力でどのように表されるかを示します。

デフォルト値: SERIAL_NUMBER

ValueRenderOption enum (ValueRenderOption) 取得した値が出力でどのように表されるかを示します。

デフォルト値: FORMATTED_VALUE

タスク出力

スプレッドシート - Batch Get タスクは、スプレッドシート 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]
            ]
          }
        ]
      }

エラー処理方法

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

割り当てと上限

割り当てと上限については、割り当てと上限をご覧ください。

次のステップ