---
title: Microsoft Excel
description: データの読み取り、書き込み、更新
---

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

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

{/* MANUAL-CONTENT-START:intro */}
[Microsoft Teams](https://www.microsoft.com/en-us/microsoft-365/excel)は、データ管理、分析、視覚化を可能にする強力なスプレッドシートアプリケーションです。SimのMicrosoft Excel統合を通じて、プログラムによるスプレッドシートデータの読み取り、書き込み、操作が可能になり、ワークフロー自動化のニーズをサポートします。

Microsoft Excel統合により、以下のことが可能になります：

- **スプレッドシートデータの読み取り**：特定の範囲、シート、セルからデータにアクセス
- **データの書き込みと更新**：新しいデータの追加や既存のスプレッドシートコンテンツの修正
- **テーブルの管理**：表形式のデータ構造の作成と操作
- **複数シートの処理**：ワークブック内の複数のワークシートの操作
- **データ処理**：スプレッドシートデータのインポート、エクスポート、変換

Simでは、Microsoft Excel統合によりOAuth認証を通じてスプレッドシート機能にシームレスにアクセスできます。特定の範囲からデータを読み取り、新しい情報を書き込み、既存のセルを更新し、さまざまなデータ形式を処理することができます。この統合は、柔軟な入出力オプションを備えた読み取りと書き込みの両方の操作をサポートしています。これにより、分析のための情報抽出、レコードの自動更新、アプリケーション間のデータ一貫性の維持など、スプレッドシートデータを効果的に管理するワークフローを構築することができます。
{/* MANUAL-CONTENT-END */}

## 使用方法

Microsoft Excelをワークフローに統合します。読み取り、書き込み、更新、テーブルへの追加、新しいワークシートの作成が可能です。

## ツール

### `microsoft_excel_read`

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

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | 読み取り元のスプレッドシートID |
| `range` | string | いいえ | 読み取るセル範囲。「シート名!A1:B2」のような明示的な範囲指定や、単に「シート名」と指定してそのシートの使用範囲を読み取ることができます。省略した場合、最初のシートの使用範囲を読み取ります。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `data` | object | スプレッドシートからの範囲データ |

### `microsoft_excel_write`

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

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | 書き込み先のスプレッドシートID |
| `range` | string | いいえ | 書き込むセル範囲 |
| `values` | array | はい | スプレッドシートに書き込むデータ |
| `valueInputOption` | string | いいえ | 書き込むデータの形式 |
| `includeValuesInResponse` | boolean | いいえ | レスポンスに書き込まれた値を含めるかどうか |

#### 出力

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

### `microsoft_excel_table_add`

Microsoft Excelテーブルに新しい行を追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | テーブルを含むスプレッドシートのID |
| `tableName` | string | はい | 行を追加するテーブルの名前 |
| `values` | array | はい | テーブルに追加するデータ（配列の配列またはオブジェクトの配列） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `index` | number | 追加された最初の行のインデックス |
| `values` | array | テーブルに追加された行の配列 |
| `metadata` | object | スプレッドシートのメタデータ |

### `microsoft_excel_worksheet_add`

Microsoft Excelブックに新しいワークシート（シート）を作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | はい | ワークシートを追加するExcelブックのID |
| `worksheetName` | string | はい | 新しいワークシートの名前。ブック内で一意である必要があり、31文字を超えることはできません |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `worksheet` | object | 新しく作成されたワークシートの詳細 |

## 注意事項

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