Skip to main content

​
Google Sheets

ShanoneのGoogle Sheets連携では、Sheets APIのほぼ全機能を扱う88のツールをエージェントが利用できるようになります——値の読み書きだけでなく、書式、グラフ、フィルタ、保護範囲、テーブル、行/列管理など、多くの連携が省略しがちな機能まで含まれます。

​
はじめに

1

OAuthで接続する

エージェントにSheetsで何か作業をしてもらう(例:「Q3予算シートにグラフを追加して」)か、ShanoneダッシュボードのIntegrationsから事前に接続します。
2

Googleアカウントを認可する

ShanoneがアクセスすべきSheetsを持つアカウントでGoogleのOAuth同意画面を承認します。
3

リクエストを再試行する

接続が完了すると、google_sheets_*ツールへのshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはGoogle Sheets用に88のツールを提供しており、以下のカテゴリに分類されています。
google_sheets_create, google_sheets_get_spreadsheet, google_sheets_get_values, google_sheets_update_values, google_sheets_append_values, google_sheets_clear_values, google_sheets_batch_get_values, google_sheets_batch_update_values, google_sheets_batch_clear_values
google_sheets_add_sheet, google_sheets_delete_sheet, google_sheets_duplicate_sheet, google_sheets_copy_sheet_to, google_sheets_update_sheet_properties, google_sheets_update_spreadsheet_properties, google_sheets_get_sheet_names
google_sheets_update_cells, google_sheets_append_cells, google_sheets_repeat_cell, google_sheets_insert_range, google_sheets_delete_range, google_sheets_cut_paste, google_sheets_copy_paste, google_sheets_paste_data, google_sheets_text_to_columns, google_sheets_trim_whitespace, google_sheets_sort_range, google_sheets_find_replace, google_sheets_remove_duplicates
google_sheets_format_cells, google_sheets_update_borders, google_sheets_merge_cells, google_sheets_unmerge_cells, google_sheets_auto_fill, google_sheets_add_banding, google_sheets_update_banding, google_sheets_delete_banding, google_sheets_add_conditional_format_rule, google_sheets_update_conditional_format_rule, google_sheets_delete_conditional_format_rule
google_sheets_add_chart, google_sheets_update_chart_spec, google_sheets_delete_embedded_object, google_sheets_update_embedded_object_position, google_sheets_add_slicer, google_sheets_update_slicer_spec, google_sheets_delete_slicer
google_sheets_set_basic_filter, google_sheets_clear_basic_filter, google_sheets_add_filter_view, google_sheets_update_filter_view, google_sheets_delete_filter_view, google_sheets_duplicate_filter_view, google_sheets_batch_get_values_by_data_filter, google_sheets_batch_update_values_by_data_filter
google_sheets_add_table, google_sheets_update_table, google_sheets_delete_table, google_sheets_add_named_range, google_sheets_update_named_range, google_sheets_delete_named_range, google_sheets_add_protected_range, google_sheets_update_protected_range, google_sheets_delete_protected_range
google_sheets_insert_dimension, google_sheets_delete_dimension, google_sheets_move_dimension, google_sheets_append_dimension, google_sheets_update_dimension_properties, google_sheets_auto_resize_dimensions, google_sheets_add_dimension_group, google_sheets_delete_dimension_group, google_sheets_update_dimension_group
google_sheets_list_comments, google_sheets_create_comment, google_sheets_reply_to_comment, google_sheets_resolve_comment
google_sheets_set_data_validation, google_sheets_get_data_validation_rules, google_sheets_create_developer_metadata, google_sheets_search_developer_metadata, google_sheets_get_developer_metadata, google_sheets_update_developer_metadata
google_sheets_search_spreadsheets, google_sheets_copy_spreadsheet, google_sheets_export_spreadsheet, google_sheets_share_spreadsheet, google_sheets_delete_spreadsheet

​
よくある使い方

自動レポート作成

シートに最新データを取り込み、書式を整え、一度の操作でグラフまで追加する

データクリーンアップ

大きな範囲に対して空白のトリム、重複削除、検索/置換を行う

アクセス制御されたテンプレート

重要な範囲を保護し、適切な権限レベルでスプレッドシートを共有する

ダッシュボード構築

名前付き範囲、フィルタビュー、スライサーを追加して生データを使いやすいダッシュボードに変える

​
トラブルシューティング

A1表記の範囲(例:Sheet1!B2:D10)を再確認してください——シート名を省略すると最初のシートがデフォルトになり、意図しない上書きの典型的な原因になります。
グラフ、テーブル、交互の色、保護範囲などの構造系ツールの多くは、シート名ではなくsheetId(数値ID)を必要とします——先にgoogle_sheets_get_spreadsheetやgoogle_sheets_get_sheet_namesを呼んで解決してください。
google_sheets_batch_update_valuesのようなバッチツールは各範囲を個別に処理します——全体が成功したからといって全範囲が成功したとは限らないため、レスポンス内の範囲ごとのエラーを確認してください。