Google スプレッドシート データの読み取り、書き込み、更新
Google スプレッドシート は、ユーザーがリアルタイムでスプレッドシートを作成、編集、共同作業できる強力なクラウドベースのスプレッドシートアプリケーションです。Googleの生産性スイートの一部として、Google スプレッドシートは堅牢な書式設定、数式、共有機能を備えたデータ整理、分析、視覚化のための多目的プラットフォームを提供しています。
Simで Google スプレッドシートの「読み取り」ツールを統合して、ワークフローに組み込むためにスプレッドシートからデータを簡単に取得する方法を学びましょう。このチュートリアルでは、Google スプレッドシートの接続、データ読み取りの設定、およびその情報を使用してリアルタイムでプロセスを自動化する方法を説明します。ライブデータをエージェントと同期させるのに最適です。
VIDEO
Simで Google スプレッドシートの「書き込み」ツールを使用して、ワークフローからGoogle スプレッドシートにデータを自動的に送信する方法を発見しましょう。このチュートリアルでは、統合のセットアップ、書き込み操作の設定、ワークフローの実行に伴うシートのシームレスな更新について説明します。手動入力なしでリアルタイムの記録を維持するのに最適です。
VIDEO
Simで Google スプレッドシートの「更新」ツールを活用して、ワークフローの実行に基づいてスプレッドシートの既存のエントリを変更する方法を探りましょう。このチュートリアルでは、更新ロジックの設定、データフィールドのマッピング、変更の即時同期を実演します。データを最新かつ一貫した状態に保つのに最適です。
VIDEO
Simでグーグルシートの「追加」ツールを使用して、ワークフロー実行中にスプレッドシートに新しいデータ行を簡単に追加する方法を学びましょう。このチュートリアルでは、連携の設定、追加アクションの構成、スムーズなデータ拡張の確保について説明します。手動作業なしでレコードを拡張するのに最適です！
VIDEO
グーグルシートでは、以下のことができます：
スプレッドシートの作成と編集 ：包括的な書式設定と計算オプションを備えたデータ駆動型ドキュメントを開発リアルタイムでの共同作業 ：同じスプレッドシートで複数のユーザーと同時に作業データ分析 ：数式、関数、ピボットテーブルを使用してデータを処理し理解情報の視覚化 ：チャート、グラフ、条件付き書式を作成してデータを視覚的に表現どこからでもアクセス ：自動クラウド同期により複数のデバイスでグーグルシートを使用オフラインでの作業 ：インターネット接続なしで作業を続け、オンラインに戻ったときに変更を同期他のサービスとの統合 ：グーグルドライブ、フォーム、サードパーティアプリケーションと連携
Simでは、グーグルシート連携によりエージェントがプログラムでスプレッドシートデータと直接やり取りできるようになります。これにより、データ抽出、分析、レポート作成、管理などの強力な自動化シナリオが可能になります。エージェントは既存のスプレッドシートから情報を抽出したり、スプレッドシートにデータを書き込んだり、新しいスプレッドシートを一から作成したりできます。この連携はAIワークフローとデータ管理の間のギャップを埋め、構造化データとのシームレスな相互作用を可能にします。Simとグーグルシートをつなげることで、データワークフローの自動化、レポート生成、データからの洞察抽出、最新情報の維持などを、すべてインテリジェントエージェントを通じて行うことができます。この連携はさまざまなデータ形式と範囲指定をサポートし、グーグルシートの共同作業とアクセシビリティの特性を維持しながら、多様なデータ管理ニーズに対応できる柔軟性を備えています。
Google Sheetsをワークフローに統合します。データの読み取り、書き込み、追加、更新が可能です。OAuthが必要です。
Google Sheetsスプレッドシートからデータを読み取る
パラメータ 型 必須 説明 spreadsheetIdstring はい スプレッドシートのID（URLで確認できます: docs.google.com/spreadsheets/d/{SPREADSHEET_ID}/edit） rangestring いいえ 読み取るA1表記の範囲（例: "Sheet1!A1:D10"、"A1:B5"）。指定しない場合、デフォルトで最初のシートのA1:Z1000が使用されます。
パラメータ 型 説明 datajson 範囲とセル値を含むシートデータ metadatajson IDとURLを含むスプレッドシートのメタデータ
Google Sheetsスプレッドシートにデータを書き込む
パラメータ 型 必須 説明 spreadsheetIdstring はい スプレッドシートのID rangestring いいえ 書き込むA1表記の範囲（例: "Sheet1!A1:D10"、"A1:B5"） valuesarray はい 2次元配列（例: [["名前", "年齢"], ["Alice", 30], ["Bob", 25]]）またはオブジェクトの配列として書き込むデータ valueInputOptionstring いいえ 書き込むデータの形式 includeValuesInResponseboolean いいえ レスポンスに書き込まれた値を含めるかどうか
パラメータ 型 説明 updatedRangestring 更新されたセル範囲 updatedRowsnumber 更新された行数 updatedColumnsnumber 更新された列数 updatedCellsnumber 更新されたセル数 metadatajson IDとURLを含むスプレッドシートのメタデータ
Google Sheetsスプレッドシートのデータを更新する
パラメータ 型 必須 説明 spreadsheetIdstring はい 更新するスプレッドシートのID rangestring いいえ 更新するA1表記の範囲（例: "Sheet1!A1:D10"、"A1:B5"） valuesarray はい 2次元配列（例: [["名前", "年齢"], ["Alice", 30]]）またはオブジェクトの配列として更新するデータ valueInputOptionstring いいえ 更新するデータの形式 includeValuesInResponseboolean いいえ レスポンスに更新された値を含めるかどうか
パラメータ 型 説明 updatedRangestring 更新されたセルの範囲 updatedRowsnumber 更新された行数 updatedColumnsnumber 更新された列数 updatedCellsnumber 更新されたセル数 metadatajson IDとURLを含むスプレッドシートのメタデータ
Google Sheetsスプレッドシートの末尾にデータを追加する
パラメータ 型 必須 説明 spreadsheetIdstring はい 追加先のスプレッドシートID rangestring いいえ 追加するセル範囲 valuesarray はい 追加するデータ valueInputOptionstring いいえ 追加するデータの形式 insertDataOptionstring いいえ データの挿入方法（上書きまたは行の挿入） includeValuesInResponseboolean いいえ レスポンスに追加された値を含めるかどうか
パラメータ 型 説明 tableRangestring データが追加されたテーブルの範囲 updatedRangestring 更新されたセルの範囲 updatedRowsnumber 更新された行数 updatedColumnsnumber 更新された列数 updatedCellsnumber 更新されたセル数 metadatajson IDとURLを含むスプレッドシートのメタデータ
カテゴリー: tools
タイプ: google_sheets
パラメータ 型 必須 説明 spreadsheetIdstring はい グーグルシートのスプレッドシートID includeGridDataboolean いいえ グリッドデータ（セル値）を含めるかどうか。デフォルトはfalse。
パラメータ 型 説明 spreadsheetIdstring スプレッドシートID titlestring スプレッドシートのタイトル localestring スプレッドシートのロケール timeZonestring スプレッドシートのタイムゾーン spreadsheetUrlstring スプレッドシートのURL sheetsarray スプレッドシート内のシートのリスト ↳ sheetId number シートID ↳ title string シートのタイトル/名前 ↳ index number シートのインデックス（位置） ↳ rowCount number シート内の行数 ↳ columnCount number シート内の列数 ↳ hidden boolean シートが非表示かどうか
新しいグーグルシートのスプレッドシートを作成
パラメータ 型 必須 説明 titlestring はい 新しいスプレッドシートのタイトル sheetTitlesjson いいえ 作成するシート名の配列（例：["Sheet1", "Data", "Summary"]）。デフォルトは単一の「Sheet1」。 localestring いいえ スプレッドシートのロケール（例："en_US"） timeZonestring いいえ スプレッドシートのタイムゾーン（例："America/New_York"）
パラメータ 型 説明 spreadsheetIdstring 作成されたスプレッドシートのID titlestring 作成されたスプレッドシートのタイトル spreadsheetUrlstring 作成されたスプレッドシートのURL sheetsarray スプレッドシートに作成されたシートのリスト ↳ sheetId number シートID ↳ title string シートのタイトル/名前 ↳ index number シートのインデックス(位置)
1回のリクエストでグーグルシートスプレッドシートから複数の範囲を読み取ります
パラメータ 型 必須 説明 spreadsheetIdstring はい グーグルシートスプレッドシートID rangesjson はい 読み取る範囲の配列(例:[["Sheet1!A1:D10", "Sheet2!A1:B5"]])。各範囲にはシート名を含める必要があります。 majorDimensionstring いいえ 値の主要な次元:「ROWS」(デフォルト)または「COLUMNS」 valueRenderOptionstring いいえ 値のレンダリング方法:「FORMATTED_VALUE」(デフォルト)、「UNFORMATTED_VALUE」、または「FORMULA」
パラメータ 型 説明 spreadsheetIdstring スプレッドシートID valueRangesarray スプレッドシートから読み取られた値範囲の配列 ↳ range string 読み取られた範囲 ↳ majorDimension string 主要な次元(ROWSまたはCOLUMNS) ↳ values array 2次元配列としてのセル値 metadatajson IDとURLを含むスプレッドシートのメタデータ ↳ spreadsheetId string グーグルシートスプレッドシートID ↳ spreadsheetUrl string スプレッドシートURL
1回のリクエストでグーグルシートスプレッドシートの複数の範囲を更新
パラメータ 型 必須 説明 spreadsheetIdstring はい グーグルシートスプレッドシートID datajson はい 更新する値範囲の配列。各項目には「range」（例：「Sheet1!A1:D10」）と「values」（2次元配列）が必要です。 valueInputOptionstring いいえ 入力データの解釈方法：「RAW」または「USER_ENTERED」（デフォルト）。USER_ENTEREDは数式を解析します。
パラメータ 型 説明 spreadsheetIdstring スプレッドシートID totalUpdatedRowsnumber 更新された行の合計数 totalUpdatedColumnsnumber 更新された列の合計数 totalUpdatedCellsnumber 更新されたセルの合計数 totalUpdatedSheetsnumber 更新されたシートの合計数 responsesarray 各範囲の更新レスポンスの配列 ↳ spreadsheetId string スプレッドシートID ↳ updatedRange string 更新された範囲 ↳ updatedRows number この範囲で更新された行数 ↳ updatedColumns number この範囲で更新された列数 ↳ updatedCells number この範囲で更新されたセル数 metadatajson IDとURLを含むスプレッドシートのメタデータ ↳ spreadsheetId string グーグルシートスプレッドシートID ↳ spreadsheetUrl string スプレッドシートURL
1回のリクエストでGoogle Sheetsスプレッドシート内の複数範囲をクリアします
パラメータ 型 必須 説明 spreadsheetIdstring はい Google SheetsスプレッドシートID rangesjson はい クリアする範囲の配列（例: ["Sheet1!A1:D10", "Sheet2!A1:B5"]）。各範囲にはシート名を含めてください。
パラメータ 型 説明 spreadsheetIdstring スプレッドシートID clearedRangesarray クリアされた範囲の配列 metadatajson IDとURLを含むスプレッドシートのメタデータ ↳ spreadsheetId string Google SheetsスプレッドシートID ↳ spreadsheetUrl string スプレッドシートURL
シートを別のスプレッドシートにコピーします
パラメータ 型 必須 説明 sourceSpreadsheetIdstring はい コピー元のGoogle SheetsスプレッドシートID sheetIdnumber はい コピーするシートのID（数値ID、シート名ではありません）。シートIDは「Get Spreadsheet」で確認できます。 destinationSpreadsheetIdstring はい コピー先のスプレッドシートID
パラメータ 型 説明 sheetIdnumber コピー先で新しく作成されたシートのID titlestring コピーされたシートのタイトル indexnumber コピーされたシートのインデックス（位置） sheetTypestring シートの種類（GRID、CHARTなど） destinationSpreadsheetIdstring コピー先のスプレッドシートID destinationSpreadsheetUrlstring コピー先スプレッドシートのURL