EAに外部シート連携を追加したい時に整理すること｜Google Sheets・CSV・WebRequest

EAを運用していると、「設定値をGoogle Sheetsで管理したい」「EAの稼働状態を外部シートへ書き出したい」「取引履歴をCSVに残したい」「外部シートで停止条件を切り替えたい」と考えることがあります。

外部シート連携は便利ですが、単に「シートと連携したい」だけでは仕様が不足する場合があります。EAが外部シートから何を読むのか、何を書き込むのか、どのタイミングで更新するのか、通信に失敗した時にどうするのかを分けて整理する必要があります。

特に、Google Sheetsや外部APIを使う場合は、認証、権限、WebRequest許可URL、API制限、送信頻度、タイムアウト、失敗時ログの確認が必要です。

また、外部シートでEAの動作を制御する場合は、signal、execution、risk、exit、external control を混同しないことが重要です。外部シートの値をそのまま売買判断に使うのか、停止条件や設定値として使うのかで、設計方針が変わります。

この記事では、EAに外部シート連携を追加したい時に、開発依頼前に整理したいGoogle Sheets、CSV、WebRequest、読込・書込、認証、権限、更新頻度、失敗時処理、ログ確認をまとめます。

なお、この記事はEA改修や開発依頼前の技術確認を目的とした内容です。外部シートを使った売買指示、推奨エントリー、推奨ロット、利益保証を行うものではありません。

この記事で確認すること

EAの外部シート連携とは

EAの外部シート連携とは、EAの設定値、稼働状態、取引履歴、エラー情報、集計結果などを、MT4/MT5の外部にあるシートやファイルと連携する仕組みです。

外部シート連携には、大きく分けて「EAが外部から読む連携」と「EAが外部へ書き込む連携」があります。

依頼前には、外部シートを「設定を読むため」に使うのか、「履歴を書き込むため」に使うのか、「運用状態を確認するため」に使うのかを分けて整理してください。

読込連携で整理すること

読込連携では、EAが外部シートから値を取得し、EA内部の動作に反映します。

読込対象には、稼働ON/OFF、BUY許可、SELL許可、新規停止、ナンピン停止、ロット設定、時間帯、対象銘柄、通知設定などがあります。

外部シートから読む値は、EA内部のinput初期値とは別に、runtime状態として扱う場合があります。依頼時には、input初期値と外部シートから取得した現在値を混同しないようにしてください。

書込連携で整理すること

書込連携では、EAが外部シートへ稼働状態、注文履歴、決済履歴、エラー、集計情報などを書き込みます。

書込対象を増やしすぎると、通信回数が増えたり、シートが重くなったり、失敗時の処理が複雑になる場合があります。そのため、何を必須で書くのか、何はログだけでよいのかを整理します。

書込連携では、追記型にするのか、最新状態を上書きするのかで設計が変わります。運用記録として残したいのか、現在状態だけを見たいのかを分けて整理してください。

Google Sheets連携で確認すること

Google Sheetsを使う場合は、EAから直接アクセスする方式、Webアプリや中継サーバーを経由する方式、CSV公開データとして読む方式など、複数の構成が考えられます。

どの方式を使うかによって、認証、権限、URL管理、セキュリティ、更新頻度、失敗時処理が変わります。

Google Sheetsは外部サービスであるため、利用時点の仕様、認証方式、権限、制限を確認したうえで設計してください。

CSV連携で確認すること

CSV連携は、EAの設定や履歴をファイルとして扱う方法です。

Google Sheetsなどの外部APIより構成が単純になる場合がありますが、保存場所、文字コード、区切り文字、ファイル肥大化、バックテスト時の扱い、VPS上のファイル管理を確認する必要があります。

CSV連携は、外部APIを使わずに運用記録を残したい場合や、あとからExcelやGoogle Sheetsへ取り込む用途で検討できます。

WebRequestで確認すること

MT5から外部サービスへ通信する場合、WebRequestを使うことがあります。

WebRequestを使う場合は、EA側のコードだけでなく、MT5側の許可URL、送信方式、タイムアウト、HTTP結果、失敗時ログを整理する必要があります。

WebRequestを使う外部連携では、通信失敗が発生しても、EAの売買処理をどう扱うかを明確にすることが重要です。

外部シートで制御する範囲を整理する

外部シートからEAの動作を制御する場合は、制御範囲を明確にする必要があります。

外部シートの値で何でも変更できるようにすると、便利な反面、誤入力、反映タイミング、検証困難、責務混在の問題が出る場合があります。

外部シート連携では、「外部制御はFIRST_ENTRY_ONLYにする」「既存ポジションの決済管理は継続する」など、影響範囲を明確にしておくと安全に設計しやすくなります。

更新頻度と反映タイミングを整理する

外部シート連携では、どのタイミングでシートを読むか、どのタイミングで書き込むかを決める必要があります。

OnTickごとに毎回通信すると、通信回数が多くなりすぎたり、EAの動作に影響したり、外部サービス側の制限にかかる場合があります。そのため、更新頻度を設計することが重要です。

更新頻度は、速ければよいとは限りません。外部連携は、EA本体の判定や注文処理に影響しないように設計する必要があります。

失敗時処理を整理する

外部シート連携では、通信失敗、認証失敗、権限不足、シート構造変更、CSV読込失敗などが起きる可能性があります。

そのため、連携に失敗した時にEAをどう動かすかを、あらかじめ仕様として決めておく必要があります。

外部シート連携の失敗時処理は、EAのリスク管理や決済処理と競合しないように設計する必要があります。

シート構造を整理する

外部シート連携では、シートの列構成やキー項目が重要です。

列名が変わる、行の位置が変わる、空欄が入る、数値と文字列が混ざる、といった状態になると、EA側で正しく読み取れない場合があります。

シート構造は、運用中に簡単に変えない前提で設計することが重要です。見た目の分かりやすさだけでなく、EAが安定して読み取れる構造にする必要があります。

ログで確認したい項目

外部シート連携では、連携が成功したのか、失敗したのか、取得した値をEAがどう扱ったのかをログで確認できることが重要です。

ログには、APIキー、Webhook URL、トークン、口座番号などの機密情報をそのまま出さないように注意してください。

バックテストと実運用で分けて考える

外部シート連携は、バックテストと実運用で挙動が変わる場合があります。

バックテストでは外部通信を使わず固定値で検証する、テスト用CSVを使う、外部書込を無効化するなど、検証用の設定を分けておくと確認しやすくなります。

外部連携の開発では、開発・検証用設定と利用者向け設定を分け、検証用設定と実運用設定を混同しないことが重要です。

外部シート連携とあわせて通知機能を追加する場合

EAの通知機能とは

EAの通知機能とは、EAの状態や取引イベントを、チャート上だけでなく外部の通知先やログへ送る機能です。

通知対象には、エントリー、決済、注文失敗、SL/TP変更、建値移動、トレーリング、認証結果、WebRequestエラー、稼働開始、稼働停止、スプレッドブロック、時間帯ブロックなどがあります。

依頼前には、通知したいイベントを一覧にし、「必ず通知するもの」と「必要な時だけ通知するもの」を分けて整理してください。

通知先を整理する

通知機能を追加する場合は、どこへ通知するかを先に決める必要があります。

通知先によって、実装方法、必要な設定、送信形式、認証情報、失敗時の確認方法が変わります。

複数の通知先を使う場合は、すべてに同じ内容を送るのか、通知先ごとに内容を変えるのかも整理してください。

通知タイミングを整理する

通知機能では、いつ通知するかが重要です。

通知タイミングが曖昧だと、同じイベントが何度も通知されたり、重要なエラーだけ通知されなかったりする場合があります。

通知タイミングは、OnTickごとに送るのではなく、状態変化やイベント発生時に送る設計にすると整理しやすくなります。

通知内容を整理する

通知内容は、あとから見返した時に何が起きたか分かるように整理します。

ただし、通知文に情報を詰め込みすぎると読みづらくなります。通知先ごとに、必要な項目を分けて考えます。

口座番号、トークン、Webhook URL、APIキーなどの機密情報は、通知文や公開ログにそのまま出さないように注意してください。

Discord通知を追加したい場合

Discord通知では、指定したチャンネルへEAの状態やイベントを送る設計がよく使われます。

Discordへ通知する場合は、Webhook URL、通知先チャンネル、メッセージ形式、送信頻度、失敗時ログを整理します。

Discord通知は、送信頻度が多すぎると確認しづらくなったり、外部サービス側の制限にかかったりする場合があります。依頼前に、どのイベントだけ通知するかを整理してください。

メール通知を追加したい場合

メール通知は、重要なイベントやエラーをメールで受け取りたい場合に検討します。

MT4/MT5側のメール設定を使う場合は、送信先、件名、本文、送信タイミング、送信失敗時の確認方法を整理します。

メール通知は、重要なエラーや停止通知には向いていますが、頻繁なエントリー通知や細かい状態通知をすべて送ると確認が難しくなる場合があります。

LINE連携を検討する場合

LINEでEA通知を受け取りたい場合は、現在利用できる通知方式を確認する必要があります。

LINE系の通知サービスは、提供状況やAPI仕様が変わる場合があります。そのため、古いトークン方式や過去の通知サービスを前提にせず、現行の利用可能な方式、認証、送信条件、費用、利用規約を確認してから仕様を決めることが重要です。

LINE連携は、外部サービス仕様の確認が必要なため、依頼時点で利用可能な方式を確認したうえで、代替通知先もあわせて整理しておくと安全です。

通知頻度と重複通知を整理する

通知機能では、通知が多すぎると確認しづらくなります。

特にOnTickで条件を確認するEAでは、同じ条件が続いている間に同じ通知を何度も送ってしまう場合があります。そのため、通知済みフラグ、送信間隔、状態変化時のみ通知などの制御が必要です。

依頼前には、「全部通知する」のではなく、どの通知を必須にするか、どの通知はログだけでよいかを整理してください。

ログ出力もあわせて整理する

通知機能を追加する場合は、通知そのものだけでなく、ログ出力も重要です。

通知が届かなかった時に、EA側で送信しなかったのか、送信したが外部サービス側で失敗したのか、WebRequestが許可されていなかったのかを区別できるようにします。

通知ログには、Webhook URLやトークンなどの機密情報をそのまま出さず、必要に応じてマスクする設計が必要です。

通知失敗時の扱いを決める

外部通知は、通信状況、サービス側の制限、設定ミス、認証情報の誤りなどで失敗する場合があります。

通知失敗時に、EAの売買処理を止めるのか、通知だけ失敗としてログに残すのかは、あらかじめ決めておく必要があります。

通知機能は、EA本体のsignal、execution、risk、exitとは分けて扱うと、保守や不具合確認がしやすくなります。

テスト通知と本番通知を分ける

通知機能を追加する場合は、テスト通知と本番通知を分けて確認できるようにすると安全です。

たとえば、EA起動時にテスト通知を送る、設定画面で通知テストを有効にする、検証用チャンネルへ送る、本番用Webhookと検証用Webhookを分ける、といった方法があります。

依頼前に用意するとよい資料

外部シート連携を依頼する場合は、EA本体だけでなく、シート構造、読込項目、書込項目、更新頻度、失敗時処理を整理します。

依頼前チェック表

FAQ

EAにGoogle Sheets連携を追加できますか？

ソースコードがあり、外部通信や認証方式を設計できる場合は相談できます。読込か書込か、シート構造、認証、権限、更新頻度、失敗時処理を整理してください。

CSV連携とGoogle Sheets連携はどちらがよいですか？

用途によって異なります。CSVはローカル記録や簡易出力に向き、Google Sheetsは外部から確認・編集しやすい反面、認証や通信、API制限の確認が必要です。

外部シートの値でEAを停止できますか？

設計次第で可能です。ただし、新規エントリー停止、追加停止、決済管理継続など、どの機能を止めるかを分けて整理する必要があります。

WebRequestが失敗した時はどうなりますか？

仕様によります。前回値を使う、デフォルト値へ戻す、新規停止する、ログだけ残す、再試行するなど、依頼前に失敗時処理を決めておく必要があります。

バックテストでも外部シート連携を使えますか？

実運用と同じ外部通信を使うかは慎重に分ける必要があります。バックテストでは固定値、検証用CSV、外部書込無効など、検証用の設計にする場合があります。

ex5ファイルだけでも外部シート連携を追加できますか？

ex5だけでは既存EAへ直接外部シート連携を追加できない場合があります。通常はmq5やmqhなどのソースコードが必要です。ソースがない場合は、補助EAや外部監視ツールとして検討する場合があります。

追加・移行する機能についてよくある質問

EAにDiscord通知を追加できますか？

ソースコードがあり、外部送信が可能な設計であれば相談できます。Webhook URL、通知イベント、通知文、WebRequest設定、送信頻度、失敗時ログを整理してください。

LINE通知を追加できますか？

LINE連携は、現在利用できる方式や外部サービス仕様を確認したうえで検討します。古い通知方式が使える前提にせず、代替通知先も含めて整理してください。

通知失敗でEAを止めるべきですか？

通知機能と売買処理は分けて考えるのが基本です。通知失敗時にEAを止めるか、ログだけ残して継続するかは、依頼前に仕様として決める必要があります。

関連ページ

相談内容に関係する設定や検証方法は、次のページで確認できます。

相談先・利用条件を確認する

あわせて確認したいページ

今回の確認内容に関連する補足ページです。必要な項目だけ確認してください。

まとめ

EAに外部シート連携を追加したい場合は、読込連携なのか、書込連携なのか、双方向連携なのかを最初に分けることが重要です。

Google Sheetsを使う場合は、認証、権限、シート構造、更新頻度、API制限、失敗時処理を確認する必要があります。CSVを使う場合は、保存場所、文字コード、列形式、追記方式、ファイル肥大化を確認します。

WebRequestを使う外部連携では、MT5側の許可URL、送信方式、タイムアウト、HTTP結果、失敗時ログを整理してください。

外部シートでEAを制御する場合は、新規エントリー停止、追加停止、決済管理継続、通知ON/OFFなど、制御範囲を明確にします。外部連携の失敗時にEA本体をどう扱うかも、依頼前に仕様として決めておく必要があります。

依頼前には、ソースコード、setファイル、シート構造、読込項目、書込項目、更新頻度、失敗時処理、ログ項目、検証環境を整理しておくと確認が進めやすくなります。

お問い合わせはEAFC公式LINEへ

EAFCサイト内の記事、商品、導入前確認、設定確認、ログ確認、開発依頼前のご相談など、各種お問い合わせはEAFC公式LINEより受け付けています。

※投資助言、売買指示、利益保証、推奨ロット、推奨銘柄の案内は行っておりません。

口座番号、認証情報、Webhook URL、GAS URL、APIキーなどの機密情報は送信しないでください。