Jinba FlowでGoogle Sheetsの行とタブを管理する

A1形式のセル範囲ではなく、列名のある行やシートのタブを操作する場合は、Google Spreadsheetツールを使います。Google OAuthで接続し、token設定にトークンを指定します。セル範囲の読み書きにはGoogle Sheetsの範囲ツールを使います。

行またはタブの操作を選ぶ

操作	ツールID	`sheet_id`と`sheet_title`以外の入力
1行を追加	`GOOGLE_SPREADSHEET_ADD_ROW`	`row`: 列名をキーとするオブジェクト
複数行を追加	`GOOGLE_SPREADSHEET_ADD_ROWS`	`rows`: 行オブジェクトの配列
行を取得	`GOOGLE_SPREADSHEET_GET_ROWS`	任意の`filters`配列
1行を更新	`GOOGLE_SPREADSHEET_UPDATE_ROW`	`row`、`unique_key`
複数行を更新	`GOOGLE_SPREADSHEET_UPDATE_ROWS`	`rows`、`unique_key`
タブを追加	`GOOGLE_SPREADSHEET_ADD_SHEET`	`headers`: 列名の配列
タブを削除	`GOOGLE_SPREADSHEET_REMOVE_SHEET`	追加の入力なし

sheet_idはスプレッドシートID、sheet_titleはタブ名です。7つのツールすべてでtoken設定を使います。GET_ROWSのフィルターにはcolumn、EQUALやCONTAINSなど大文字のoperator、valueを指定します。行はすべてのフィルターに一致する必要があります。フィルターはシート取得後に適用されます。GET_ROWSは一致した行オブジェクトの配列をresultに返します。

行データを追加する

- id: add_rows
  tool: GOOGLE_SPREADSHEET_ADD_ROWS
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: sheet_id
      value: "<スプレッドシートID>"
    - name: sheet_title
      value: "Data"
    - name: rows
      value: '[{"Name":"Ada","Status":"Ready"},{"Name":"Lin","Status":"Review"}]'

プレースホルダーを設定済みのトークンとスプレッドシートIDに置き換えます。rowsは、列名をキーにしたオブジェクトのJSON配列です。成功すると、追加された行がresult.rowsに返ります。SheetNotFoundErrorが出る場合は、タブ名と接続アカウントのアクセス権を確認します。

見出し付きのタブを作成する

GOOGLE_SPREADSHEET_ADD_SHEETを使うと、タブと見出し行をまとめて作成できます。

- id: create_monthly_report
  tool: GOOGLE_SPREADSHEET_ADD_SHEET
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: sheet_id
      value: "<スプレッドシートID>"
    - name: sheet_title
      value: "Monthly Report"
    - name: headers
      value: '["Name","Email","Status"]'

新しいタブのIDと名前はresult.sheet.idとresult.sheet.nameに入ります。GOOGLE_SPREADSHEET_REMOVE_SHEETには同じsheet_idとsheet_titleを指定します。タブを削除すると、その内容も削除されます。

一意のキーで行を更新する

GOOGLE_SPREADSHEET_UPDATE_ROWとGOOGLE_SPREADSHEET_UPDATE_ROWSは、unique_keyで指定した列を使って既存の行を照合します。各行オブジェクトにそのキーを含めてください。それ以外のキーの値で、一致した行のセルが上書きされます。UPDATE_ROWは更新した行をresult.rowに返し、一致する行がなければRowNotFoundErrorになります。UPDATE_ROWSは一致しないオブジェクトを読み飛ばし、更新した行だけをresult.rowsに返します。次のフローは、StatusがInactiveの行を読み取り、従業員ごとの更新内容を作って書き戻します。

- id: get_inactive
  tool: GOOGLE_SPREADSHEET_GET_ROWS
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: sheet_id
      value: "<スプレッドシートID>"
    - name: sheet_title
      value: "Employees"
    - name: filters
      value: '[{"column":"Status","operator":"EQUAL","value":"Inactive"}]'

- id: build_updates
  tool: PYTHON_SANDBOX_RUN
  needs: [get_inactive]
  input:
    - name: data_type
      value: OBJECT
    - name: code
      value: |
        import json

        text = r'''{{steps.get_inactive.result}}'''
        rows = json.loads(text) if text.strip() else []

        updates = [
            {"Employee ID": row["Employee ID"], "Status": "Terminated", "End Date": "2024-01-31"}
            for row in rows
            if row.get("Employee ID")
        ]

        print(json.dumps({"rows": updates}))

- id: apply_updates
  tool: GOOGLE_SPREADSHEET_UPDATE_ROWS
  needs: [build_updates]
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: sheet_id
      value: "<スプレッドシートID>"
    - name: sheet_title
      value: "Employees"
    - name: unique_key
      value: "Employee ID"
    - name: rows
      value: "{{steps.build_updates.result.data.rows}}"

EmployeesタブにはEmployee ID、Status、End Dateの見出しが必要です。Pythonステップが作ったリストはsteps.build_updates.result.data.rows、更新された行はsteps.apply_updates.result.rowsで参照できます。Inactiveの行がなければリストは空になり、何も変更されません。

タブ間で行を移行する

GOOGLE_SPREADSHEET_GET_ROWSで移行元を読み取り、行オブジェクトを変換してから、GOOGLE_SPREADSHEET_ADD_ROWSで書き込みます。移行元と移行先は、同じスプレッドシート内のタブでも別のスプレッドシートでもかまいません。

- id: read_source
  tool: GOOGLE_SPREADSHEET_GET_ROWS
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: sheet_id
      value: "<移行元のスプレッドシートID>"
    - name: sheet_title
      value: "SourceData"

- id: clean_rows
  tool: PYTHON_SANDBOX_RUN
  needs: [read_source]
  input:
    - name: data_type
      value: OBJECT
    - name: code
      value: |
        import json

        text = r'''{{steps.read_source.result}}'''
        rows = json.loads(text) if text.strip() else []

        clean = []
        for row in rows:
            name = (row.get("Name") or "").strip()
            email = (row.get("Email") or "").strip().lower()
            if not name or not email:
                continue
            clean.append({
                "Name": name.title(),
                "Email": email,
                "Department": (row.get("Department") or "").strip(),
                "Status": "Active",
            })

        print(json.dumps({"rows": clean}))

- id: write_destination
  tool: GOOGLE_SPREADSHEET_ADD_ROWS
  needs: [clean_rows]
  config:
    - name: token
      value: "<Google OAuthトークン>"
  input:
    - name: sheet_id
      value: "<移行先のスプレッドシートID>"
    - name: sheet_title
      value: "MigratedData"
    - name: rows
      value: "{{steps.clean_rows.result.data.rows}}"

Pythonステップは名前かメールアドレスが空の行を除外し、StatusにActiveを設定します。MigratedDataタブは事前に作成しておきます。たとえばGOOGLE_SPREADSHEET_ADD_SHEETで見出し["Name","Email","Department","Status"]を指定します。書き込まれた行はsteps.write_destination.result.rowsで参照できます。 GET_ROWSはフィルター適用前にタブ全体を取得するため、大きなシートの一部だけが必要な場合は範囲ツールで範囲を指定して読み取ります。一括更新の前にコピーを取り、一致しなかった行や空の結果がないか確認してください。

​行またはタブの操作を選ぶ

​行データを追加する

​見出し付きのタブを作成する

​一意のキーで行を更新する

​タブ間で行を移行する

行またはタブの操作を選ぶ

行データを追加する

見出し付きのタブを作成する

一意のキーで行を更新する

タブ間で行を移行する