Jinba FlowでGoogle Sheetsのセル範囲を読み書きする

スプレッドシートIDとSheet1!A1:D5のようなA1形式の範囲が分かっている場合は、この2つのツールを使います。Google OAuthでアカウントを接続し、token設定にそのトークンを指定します。行データやシートのタブを操作する場合はGoogle Spreadsheetツールを使います。

セル範囲を読み込む

GOOGLE_SHEETS_GET_SHEETにはspreadsheet_idとrangeが必要です。結果にはrange、majorDimension、行の配列であるvaluesが含まれる場合があります。result.valuesで想定したセルが取得されたことを確認します。

- id: read_range
  tool: GOOGLE_SHEETS_GET_SHEET
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: spreadsheet_id
      value: "<スプレッドシートID>"
    - name: range
      value: "Sheet1!A1:D5"

プレースホルダーを設定済みのトークンとスプレッドシートURL内のIDに置き換えます。結果が空、またはステップが失敗する場合は、タブ名、範囲、ID、接続アカウントのアクセス権を確認します。

行をJSONレコードとして書き出す

シートのデータをAPI、データベース、AIステップに渡すには、ヘッダー行をキーにしたレコードに変換します。旧Advancedページの構造化エクスポートの用途を残した例です。

- id: rows_to_records
  tool: PYTHON_SANDBOX_RUN
  needs: [read_range]
  input:
    - name: data_type
      value: OBJECT
    - name: code
      value: |
        import json
        text = r'''{{steps.read_range.result.values}}'''
        rows = json.loads(text) if text.strip() else []
        headers = rows[0] if rows else []
        records = [
            {h: (row[i] if i < len(row) else "") for i, h in enumerate(headers)}
            for row in rows[1:]
        ]
        print(json.dumps({"records": records, "count": len(records)}))

result.data.recordsにはデータ行ごとに1つのオブジェクト、result.data.countには行数が入ります。セルの値はすべて文字列です。範囲が空の場合、読み取りステップはvaluesを返さないため、コードでは行がないものとして扱います。

複数のシートタブを読み取る

旧Advancedページには、同じブックの複数のタブを処理する例もありました。タブごとに同じスプレッドシートIDを使って範囲を読み取ります。

- id: read_sales
  tool: GOOGLE_SHEETS_GET_SHEET
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: spreadsheet_id
      value: "<スプレッドシートID>"
    - name: range
      value: "Sales!A1:D100"

- id: read_inventory
  tool: GOOGLE_SHEETS_GET_SHEET
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: spreadsheet_id
      value: "<スプレッドシートID>"
    - name: range
      value: "Inventory!A1:D100"

後続ステップで行を結合する前に、各ステップのresult.valuesを確認します。現在のツールは指定範囲の値を返しますが、旧Advancedページに記載されていた書式やメタデータのフィールドは返しません。後続ステップで、各タブのヘッダーと行数などを1つの概要にまとめられます。

- id: combine_tabs
  tool: PYTHON_SANDBOX_RUN
  needs: [read_sales, read_inventory]
  input:
    - name: data_type
      value: OBJECT
    - name: code
      value: |
        import json

        def load(text):
            rows = json.loads(text) if text.strip() else []
            return rows[0] if rows else [], rows[1:]

        sales_headers, sales = load(r'''{{steps.read_sales.result.values}}''')
        inventory_headers, inventory = load(r'''{{steps.read_inventory.result.values}}''')
        print(json.dumps({
            "tabs": {
                "Sales": {"headers": sales_headers, "row_count": len(sales)},
                "Inventory": {"headers": inventory_headers, "row_count": len(inventory)},
            },
            "total_rows": len(sales) + len(inventory),
        }))

result.dataをレポート作成ステップの入力にするか、共通の列でタブ間の行を結合するようにコードを拡張します。

利用前にデータを確認する

ワークフローに必要な列と行だけを読み取り、別のツールへ渡す前に確認します。次の例は範囲を限定して注文データを読み取り、必須セルの空欄や想定外の状態値がある行を報告します。

- id: read_orders
  tool: GOOGLE_SHEETS_GET_SHEET
  config:
    - name: token
      value: "<Google OAuth token>"
  input:
    - name: spreadsheet_id
      value: "<spreadsheet ID>"
    - name: range
      value: "Orders!A1:D100"

- id: check_orders
  tool: PYTHON_SANDBOX_RUN
  needs: [read_orders]
  input:
    - name: data_type
      value: OBJECT
    - name: code
      value: |
        import json
        text = r'''{{steps.read_orders.result.values}}'''
        rows = json.loads(text) if text.strip() else []
        headers = rows[0] if rows else []
        required = ["Order ID", "Customer", "Status"]
        allowed_status = {"open", "shipped", "cancelled"}
        problems = []
        for n, row in enumerate(rows[1:], start=2):
            record = {h: (row[i].strip() if i < len(row) else "") for i, h in enumerate(headers)}
            missing = [f for f in required if not record.get(f)]
            if missing:
                problems.append({"row": n, "issue": "missing " + ", ".join(missing)})
            elif record["Status"].lower() not in allowed_status:
                problems.append({"row": n, "issue": "unexpected status " + record["Status"]})
        print(json.dumps({"checked_rows": len(rows) - 1 if rows else 0, "problems": problems}))

result.data.problemsには、問題ごとにシートの行番号が入ります。データを使う前に、この結果で分岐するか担当者に送ります。列名と許可する状態値は実際のものに置き換えてください。読み取りツールが返すのはセルの値だけです。書式、数式のメタデータ、入力規則は返しません。

セルに値を書き込む・追記する

GOOGLE_SHEETS_EDIT_SHEETにはspreadsheet_id、range、valuesが必要です。valuesは行を表すJSON文字列であり、YAML配列ではありません。任意のappend_to_bottomを設定すると、範囲への書き込みではなく末尾への追記になります。

- id: write_range
  tool: GOOGLE_SHEETS_EDIT_SHEET
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: spreadsheet_id
      value: "<スプレッドシートID>"
    - name: range
      value: "Sheet1!A1:B2"
    - name: values
      value: '[["名前","状態"],["Ada","準備完了"]]'

書き込みに成功するとresult.updated_rangeが返ります。同じ範囲を読み込むステップを実行し、値が書き込まれたことを確認します。以前のGET_SHEETではなく、現在のツールIDGOOGLE_SHEETS_GET_SHEETを使ってください。

​セル範囲を読み込む

​行をJSONレコードとして書き出す

​複数のシートタブを読み取る

​利用前にデータを確認する

​セルに値を書き込む・追記する

セル範囲を読み込む

行をJSONレコードとして書き出す

複数のシートタブを読み取る

利用前にデータを確認する

セルに値を書き込む・追記する