​
概要

Googleスプレッドシート上級ツールは、Googleシートでの一括操作のための包括的な機能を提供します。これらのツールは、複数行、シート、複雑なデータ操作の管理のための高度な機能で基本的なGoogleシートツールを補完します。

​
主な機能

  • GOOGLE_SPREADSHEET_ADD_ROW
    • Googleシートに単一行を追加
  • GOOGLE_SPREADSHEET_ADD_ROWS
    • Googleシートに一度に複数行を追加
  • GOOGLE_SPREADSHEET_UPDATE_ROW
    • Googleシートの特定の行を更新
  • GOOGLE_SPREADSHEET_UPDATE_ROWS
    • Googleシートの複数行を更新
  • GOOGLE_SPREADSHEET_GET_ROWS
    • Googleシートから複数行を取得
  • GOOGLE_SPREADSHEET_ADD_SHEET
    • Googleスプレッドシート内に新しいシートを作成
  • GOOGLE_SPREADSHEET_REMOVE_SHEET
    • Googleスプレッドシートからシートを削除

​
認証

GoogleシートAPI認証情報を設定する必要があります。以下の手順に従ってください：
  1. Google Cloud Consoleにアクセス
  2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択
  3. Google Sheets APIを有効にする
  4. サービスアカウント認証情報を作成し、JSONキーファイルをダウンロード
  5. サービスアカウントのメールアドレスとGoogleスプレッドシートを共有
注意: API認証情報は機密情報として扱い、パブリックリポジトリにコミットしないでください。

​
例: 一括データ操作

- id: add_multiple_rows
  name: add_multiple_rows
  tool: GOOGLE_SPREADSHEET_ADD_ROWS
  config:
    - name: credentials
      value: "{{secrets.GOOGLE_SHEETS_CREDENTIALS}}"
  input:
    - name: spreadsheet_id
      value: "your_spreadsheet_id_here"
    - name: sheet_name
      value: "データ"
    - name: values
      value: [
        ["田中太郎", "tanaka@example.com", "マネージャー", "2024-01-15"],
        ["佐藤花子", "sato@example.com", "開発者", "2024-01-16"],
        ["鈴木一郎", "suzuki@example.com", "デザイナー", "2024-01-17"]
      ]

- id: update_multiple_rows
  name: update_multiple_rows
  tool: GOOGLE_SPREADSHEET_UPDATE_ROWS
  config:
    - name: credentials
      value: "{{secrets.GOOGLE_SHEETS_CREDENTIALS}}"
  input:
    - name: spreadsheet_id
      value: "your_spreadsheet_id_here"
    - name: sheet_name
      value: "データ"
    - name: start_row
      value: 2
    - name: values
      value: [
        ["田中太郎（更新）", "tanaka.taro@example.com", "シニアマネージャー", "2024-01-15"],
        ["佐藤花子（更新）", "sato.hanako@example.com", "シニア開発者", "2024-01-16"]
      ]

​
例: シート管理

- id: create_new_sheet
  name: create_new_sheet
  tool: GOOGLE_SPREADSHEET_ADD_SHEET
  config:
    - name: credentials
      value: "{{secrets.GOOGLE_SHEETS_CREDENTIALS}}"
  input:
    - name: spreadsheet_id
      value: "your_spreadsheet_id_here"
    - name: sheet_name
      value: "月次レポート_{{current_date}}"

- id: setup_headers
  name: setup_headers
  tool: GOOGLE_SPREADSHEET_ADD_ROW
  config:
    - name: credentials
      value: "{{secrets.GOOGLE_SHEETS_CREDENTIALS}}"
  input:
    - name: spreadsheet_id
      value: "your_spreadsheet_id_here"
    - name: sheet_name
      value: "月次レポート_{{current_date}}"
    - name: values
      value: ["名前", "メール", "部署", "開始日", "ステータス"]

​
ヒントとベストプラクティス

  • 大きな更新操作の前にバックアップを作成することを検討する
  • 新しいシートを作成する際は意味のあるシート名を使用する
  • 大きなデータセットにエラーハンドリングを実装する
  • 大量操作のAPIクォータ使用量を監視する
  • より良いパフォーマンスのためにバッチ操作を使用する