---
title: Google スプレッドシート
description: データの読み取り、書き込み、更新
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="google_sheets"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Google スプレッドシート](https://sheets.google.com)は、ユーザーがリアルタイムでスプレッドシートを作成、編集、共同作業できる強力なクラウドベースのスプレッドシートアプリケーションです。Googleの生産性スイートの一部として、Google スプレッドシートは堅牢な書式設定、数式、共有機能を備えたデータ整理、分析、視覚化のための多目的プラットフォームを提供しています。

Simで Google スプレッドシートの「読み取り」ツールを統合して、ワークフローに組み込むためにスプレッドシートからデータを簡単に取得する方法を学びましょう。このチュートリアルでは、Google スプレッドシートの接続、データ読み取りの設定、およびその情報を使用してリアルタイムでプロセスを自動化する方法を説明します。ライブデータをエージェントと同期させるのに最適です。

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/xxP7MZRuq_0"
  title="Simで Google スプレッドシート読み取りツールを使用する"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Simで Google スプレッドシートの「書き込み」ツールを使用して、ワークフローからGoogle スプレッドシートにデータを自動的に送信する方法を発見しましょう。このチュートリアルでは、統合のセットアップ、書き込み操作の設定、ワークフローの実行に伴うシートのシームレスな更新について説明します。手動入力なしでリアルタイムの記録を維持するのに最適です。

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/cO86qTj7qeY"
  title="Simで Google スプレッドシート書き込みツールを使用する"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Simで Google スプレッドシートの「更新」ツールを活用して、ワークフローの実行に基づいてスプレッドシートの既存のエントリを変更する方法を探りましょう。このチュートリアルでは、更新ロジックの設定、データフィールドのマッピング、変更の即時同期を実演します。データを最新かつ一貫した状態に保つのに最適です。

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/95by2fL9yn4"
  title="Simでのグーグルシート更新ツールの使用方法"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

Simでグーグルシートの「追加」ツールを使用して、ワークフロー実行中にスプレッドシートに新しいデータ行を簡単に追加する方法を学びましょう。このチュートリアルでは、連携の設定、追加アクションの構成、スムーズなデータ拡張の確保について説明します。手動作業なしでレコードを拡張するのに最適です！

<iframe
  width="100%"
  height="400"
  src="https://www.youtube.com/embed/8DgNvLBCsAo"
  title="Simでのグーグルシート追加ツールの使用方法"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

グーグルシートでは、以下のことができます：

- **スプレッドシートの作成と編集**：包括的な書式設定と計算オプションを備えたデータ駆動型ドキュメントを開発
- **リアルタイムでの共同作業**：同じスプレッドシートで複数のユーザーと同時に作業
- **データ分析**：数式、関数、ピボットテーブルを使用してデータを処理し理解
- **情報の視覚化**：チャート、グラフ、条件付き書式を作成してデータを視覚的に表現
- **どこからでもアクセス**：自動クラウド同期により複数のデバイスでグーグルシートを使用
- **オフラインでの作業**：インターネット接続なしで作業を続け、オンラインに戻ったときに変更を同期
- **他のサービスとの統合**：グーグルドライブ、フォーム、サードパーティアプリケーションと連携

Simでは、グーグルシート連携によりエージェントがプログラムでスプレッドシートデータと直接やり取りできるようになります。これにより、データ抽出、分析、レポート作成、管理などの強力な自動化シナリオが可能になります。エージェントは既存のスプレッドシートから情報を抽出したり、スプレッドシートにデータを書き込んだり、新しいスプレッドシートを一から作成したりできます。この連携はAIワークフローとデータ管理の間のギャップを埋め、構造化データとのシームレスな相互作用を可能にします。Simとグーグルシートをつなげることで、データワークフローの自動化、レポート生成、データからの洞察抽出、最新情報の維持などを、すべてインテリジェントエージェントを通じて行うことができます。この連携はさまざまなデータ形式と範囲指定をサポートし、グーグルシートの共同作業とアクセシビリティの特性を維持しながら、多様なデータ管理ニーズに対応できる柔軟性を備えています。
{/* MANUAL-CONTENT-END */}

## 使用方法

Google Sheetsをワークフローに統合します。データの読み取り、書き込み、追加、更新が可能です。OAuthが必要です。

## ツール

### `google_sheets_read`

Google Sheetsスプレッドシートからデータを読み取る

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | スプレッドシートのID（URLで確認できます: docs.google.com/spreadsheets/d/\{SPREADSHEET_ID\}/edit） |
| `range` | string | いいえ | 読み取るA1表記の範囲（例: "Sheet1!A1:D10"、"A1:B5"）。指定しない場合、デフォルトで最初のシートのA1:Z1000が使用されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `data` | json | 範囲とセル値を含むシートデータ |
| `metadata` | json | IDとURLを含むスプレッドシートのメタデータ |

### `google_sheets_write`

Google Sheetsスプレッドシートにデータを書き込む

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | スプレッドシートのID |
| `range` | string | いいえ | 書き込むA1表記の範囲（例: "Sheet1!A1:D10"、"A1:B5"） |
| `values` | array | はい | 2次元配列（例: \[\["名前", "年齢"\], \["Alice", 30\], \["Bob", 25\]\]）またはオブジェクトの配列として書き込むデータ |
| `valueInputOption` | string | いいえ | 書き込むデータの形式 |
| `includeValuesInResponse` | boolean | いいえ | レスポンスに書き込まれた値を含めるかどうか |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `updatedRange` | string | 更新されたセル範囲 |
| `updatedRows` | number | 更新された行数 |
| `updatedColumns` | number | 更新された列数 |
| `updatedCells` | number | 更新されたセル数 |
| `metadata` | json | IDとURLを含むスプレッドシートのメタデータ |

### `google_sheets_update`

Google Sheetsスプレッドシートのデータを更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | 更新するスプレッドシートのID |
| `range` | string | いいえ | 更新するA1表記の範囲（例: "Sheet1!A1:D10"、"A1:B5"） |
| `values` | array | はい | 2次元配列（例: \[\["名前", "年齢"\], \["Alice", 30\]\]）またはオブジェクトの配列として更新するデータ |
| `valueInputOption` | string | いいえ | 更新するデータの形式 |
| `includeValuesInResponse` | boolean | いいえ | レスポンスに更新された値を含めるかどうか |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `updatedRange` | string | 更新されたセルの範囲 |
| `updatedRows` | number | 更新された行数 |
| `updatedColumns` | number | 更新された列数 |
| `updatedCells` | number | 更新されたセル数 |
| `metadata` | json | IDとURLを含むスプレッドシートのメタデータ |

### `google_sheets_append`

Google Sheetsスプレッドシートの末尾にデータを追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | 追加先のスプレッドシートID |
| `range` | string | いいえ | 追加するセル範囲 |
| `values` | array | はい | 追加するデータ |
| `valueInputOption` | string | いいえ | 追加するデータの形式 |
| `insertDataOption` | string | いいえ | データの挿入方法（上書きまたは行の挿入） |
| `includeValuesInResponse` | boolean | いいえ | レスポンスに追加された値を含めるかどうか |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tableRange` | string | データが追加されたテーブルの範囲 |
| `updatedRange` | string | 更新されたセルの範囲 |
| `updatedRows` | number | 更新された行数 |
| `updatedColumns` | number | 更新された列数 |
| `updatedCells` | number | 更新されたセル数 |
| `metadata` | json | IDとURLを含むスプレッドシートのメタデータ |

## 注意事項

- カテゴリー: `tools`
- タイプ: `google_sheets`

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | グーグルシートのスプレッドシートID |
| `includeGridData` | boolean | いいえ | グリッドデータ（セル値）を含めるかどうか。デフォルトはfalse。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | スプレッドシートID |
| `title` | string | スプレッドシートのタイトル |
| `locale` | string | スプレッドシートのロケール |
| `timeZone` | string | スプレッドシートのタイムゾーン |
| `spreadsheetUrl` | string | スプレッドシートのURL |
| `sheets` | array | スプレッドシート内のシートのリスト |
|   ↳ `sheetId` | number | シートID |
|   ↳ `title` | string | シートのタイトル/名前 |
|   ↳ `index` | number | シートのインデックス（位置） |
|   ↳ `rowCount` | number | シート内の行数 |
|   ↳ `columnCount` | number | シート内の列数 |
|   ↳ `hidden` | boolean | シートが非表示かどうか |

### `google_sheets_create_spreadsheet`

新しいグーグルシートのスプレッドシートを作成

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `title` | string | はい | 新しいスプレッドシートのタイトル |
| `sheetTitles` | json | いいえ | 作成するシート名の配列（例：["Sheet1", "Data", "Summary"]）。デフォルトは単一の「Sheet1」。 |
| `locale` | string | いいえ | スプレッドシートのロケール（例："en_US"） |
| `timeZone` | string | いいえ | スプレッドシートのタイムゾーン（例："America/New_York"） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | 作成されたスプレッドシートのID |
| `title` | string | 作成されたスプレッドシートのタイトル |
| `spreadsheetUrl` | string | 作成されたスプレッドシートのURL |
| `sheets` | array | スプレッドシートに作成されたシートのリスト |
|   ↳ `sheetId` | number | シートID |
|   ↳ `title` | string | シートのタイトル/名前 |
|   ↳ `index` | number | シートのインデックス(位置) |

### `google_sheets_batch_get`

1回のリクエストでグーグルシートスプレッドシートから複数の範囲を読み取ります

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | グーグルシートスプレッドシートID |
| `ranges` | json | はい | 読み取る範囲の配列(例:[["Sheet1!A1:D10", "Sheet2!A1:B5"]])。各範囲にはシート名を含める必要があります。 |
| `majorDimension` | string | いいえ | 値の主要な次元:「ROWS」(デフォルト)または「COLUMNS」 |
| `valueRenderOption` | string | いいえ | 値のレンダリング方法:「FORMATTED_VALUE」(デフォルト)、「UNFORMATTED_VALUE」、または「FORMULA」 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | スプレッドシートID |
| `valueRanges` | array | スプレッドシートから読み取られた値範囲の配列 |
|   ↳ `range` | string | 読み取られた範囲 |
|   ↳ `majorDimension` | string | 主要な次元(ROWSまたはCOLUMNS) |
|   ↳ `values` | array | 2次元配列としてのセル値 |
| `metadata` | json | IDとURLを含むスプレッドシートのメタデータ |
|   ↳ `spreadsheetId` | string | グーグルシートスプレッドシートID |
|   ↳ `spreadsheetUrl` | string | スプレッドシートURL |

### `google_sheets_batch_update`

1回のリクエストでグーグルシートスプレッドシートの複数の範囲を更新

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | グーグルシートスプレッドシートID |
| `data` | json | はい | 更新する値範囲の配列。各項目には「range」（例：「Sheet1!A1:D10」）と「values」（2次元配列）が必要です。 |
| `valueInputOption` | string | いいえ | 入力データの解釈方法：「RAW」または「USER_ENTERED」（デフォルト）。USER_ENTEREDは数式を解析します。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | スプレッドシートID |
| `totalUpdatedRows` | number | 更新された行の合計数 |
| `totalUpdatedColumns` | number | 更新された列の合計数 |
| `totalUpdatedCells` | number | 更新されたセルの合計数 |
| `totalUpdatedSheets` | number | 更新されたシートの合計数 |
| `responses` | array | 各範囲の更新レスポンスの配列 |
|   ↳ `spreadsheetId` | string | スプレッドシートID |
|   ↳ `updatedRange` | string | 更新された範囲 |
|   ↳ `updatedRows` | number | この範囲で更新された行数 |
|   ↳ `updatedColumns` | number | この範囲で更新された列数 |
|   ↳ `updatedCells` | number | この範囲で更新されたセル数 |
| `metadata` | json | IDとURLを含むスプレッドシートのメタデータ |
|   ↳ `spreadsheetId` | string | グーグルシートスプレッドシートID |
|   ↳ `spreadsheetUrl` | string | スプレッドシートURL |

### `google_sheets_batch_clear`

1回のリクエストでGoogle Sheetsスプレッドシート内の複数範囲をクリアします

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | ---- | ----------- |
| `spreadsheetId` | string | はい | Google SheetsスプレッドシートID |
| `ranges` | json | はい | クリアする範囲の配列（例: ["Sheet1!A1:D10", "Sheet2!A1:B5"]）。各範囲にはシート名を含めてください。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `spreadsheetId` | string | スプレッドシートID |
| `clearedRanges` | array | クリアされた範囲の配列 |
| `metadata` | json | IDとURLを含むスプレッドシートのメタデータ |
|   ↳ `spreadsheetId` | string | Google SheetsスプレッドシートID |
|   ↳ `spreadsheetUrl` | string | スプレッドシートURL |

### `google_sheets_copy_sheet`

シートを別のスプレッドシートにコピーします

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | ---- | ----------- |
| `sourceSpreadsheetId` | string | はい | コピー元のGoogle SheetsスプレッドシートID |
| `sheetId` | number | はい | コピーするシートのID（数値ID、シート名ではありません）。シートIDは「Get Spreadsheet」で確認できます。 |
| `destinationSpreadsheetId` | string | はい | コピー先のスプレッドシートID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `sheetId` | number | コピー先で新しく作成されたシートのID |
| `title` | string | コピーされたシートのタイトル |
| `index` | number | コピーされたシートのインデックス（位置） |
| `sheetType` | string | シートの種類（GRID、CHARTなど） |
| `destinationSpreadsheetId` | string | コピー先のスプレッドシートID |
| `destinationSpreadsheetUrl` | string | コピー先スプレッドシートのURL |
