外部連携・通知ガイド

Google Sheets連携ツールを使う前に確認すること

EAファンクラブ

本記事は、MT4/MT5・MQL4/MQL5・EA・インジケータに関する技術情報・一般的な運用知識を解説するものです。特定の金融商品の売買、投資判断、利益獲得を推奨・保証するものではありません。

Google Sheets連携ツールを使う前に確認すること

MT5のEAやインジケータでは、取引履歴、稼働状態、通知履歴、エラー情報、検証記録などをGoogle Sheetsへ記録したり、Google Sheets側の設定値をMT5へ読み込んだりする構成があります。

Google Sheets連携は便利ですが、MT5側だけで完結する機能ではありません。MT5のWebRequest設定、Google Apps ScriptのURL、シートの共有権限、シート構造、EAやインジケータ側の入力項目、Expertsログなど、複数の確認点があります。

この記事では、Google Sheets連携ツールを使う前に確認したい項目を、導入前チェックと不具合切り分けの観点から整理します。

1. Google Sheets連携でできること

MT5とGoogle Sheetsを連携すると、EAやインジケータの情報を外部シートへ記録したり、シート側の設定値を読み取ったりできる場合があります。

代表的な用途は以下です。

  • EAの稼働状態を記録する
  • 注文・決済・通知履歴を記録する
  • 損益やポジション情報を集計する
  • エラーや停止理由を残す
  • 外部シート上のON/OFF設定を読み込む
  • 運用記録や検証メモを整理する

ただし、Google Sheets連携は、利益や損失回避を保証するものではありません。あくまで記録、確認、通知、設定管理を補助するための仕組みです。

2. 連携方式を確認する

Google Sheets連携には、いくつかの方式があります。

使用するツールによって、Google Apps Scriptを使う場合、CSV公開URLを読む場合、WebアプリURLへ送信する場合などがあります。

方式主な用途確認すること
GAS Webアプリへ送信MT5からSheetsへ記録を書き込むGAS URL、デプロイ状態、アクセス権限
CSV公開URLを取得Sheets側の設定値をMT5で読み込む公開URL、列構造、文字コード、空データ
Webhook風のURL連携外部通知や状態記録URL、パラメータ、レスポンス、ログ
手動CSV出力検証記録や履歴保存保存先、列名、取り込み形式

最初に、使用するGoogle Sheets連携ツールが「書き込み型」なのか「読み込み型」なのか、またはその両方なのかを確認してください。

3. MT5側のWebRequest設定を確認する

MT5からGoogle SheetsやGoogle Apps Scriptへ通信する場合、WebRequest設定が必要になることがあります。

確認する項目は以下です。

  • MT5でWebRequestが許可されているか
  • GAS URLまたはCSV公開URLが許可リストに登録されているか
  • URLの前後に空白や改行が入っていないか
  • テスト用URLと本番用URLを間違えていないか
  • EAやインジケータ側の外部連携機能がONになっているか
  • ExpertsログにWebRequestエラーが出ていないか

WebRequest設定が正しくない場合、Google Sheets側が正常でも、MT5から通信できません。

4. GAS URLとデプロイ状態を確認する

Google Apps Scriptを使う連携では、GASをWebアプリとしてデプロイし、そのURLをMT5側へ設定することがあります。

この場合、確認したい項目は以下です。

  • GASがWebアプリとしてデプロイされているか
  • 現在使っているURLが最新のデプロイURLか
  • GASを編集した後に再デプロイしているか
  • アクセス権限が外部からの通信を許可する状態か
  • テスト用GASと本番用GASを間違えていないか
  • 古いURLをMT5側に残したままになっていないか

GASを修正しても、デプロイ内容が更新されていない場合、MT5から見ると古い処理が動いているように見えることがあります。

外部連携全体の確認順

Google Sheets連携が反映されない場合、GAS URL、シート権限、列構成だけでなく、MT5側のWebRequest設定やVPS側の設定も確認対象になります。外部連携全体の確認順もあわせて確認してください。

5. シートの共有権限を確認する

Google Sheets連携では、シート側の権限も確認対象になります。

特に、MT5から設定値を読み取る場合や、GAS経由で書き込む場合は、外部からアクセスできる状態になっているかを確認する必要があります。

確認項目内容
共有設定外部から読み取り・書き込みできる構成か
GASの実行権限想定したアカウント権限で実行されるか
シート保護書き込み対象セルや列が保護されていないか
シート名EA側・GAS側が参照するシート名と一致しているか
列構造EA側が想定している列名・順番と一致しているか

シート名や列名を変更した場合、EAやGAS側の参照先と合わなくなることがあります。

6. シート構造を確認する

Google Sheets連携では、シートの見た目だけでなく、EAやGASが読み書きする列構造が重要です。

確認すべき項目は以下です。

  • 必要なシートタブが存在しているか
  • シート名が仕様と一致しているか
  • ヘッダー行が削除されていないか
  • 列の順番を変更していないか
  • 必須列が空欄になっていないか
  • 数値列に文字列が入っていないか
  • 日時形式が想定どおりか
  • 空行や結合セルが処理を妨げていないか

人が見やすいようにシートを編集した結果、EAやGAS側の処理が読み取れなくなることがあります。運用用シートでは、表示用の整形と、EAが読むデータ構造を分けて考えることが重要です。

7. 書き込み型連携で確認すること

MT5からGoogle Sheetsへ記録を書き込むタイプでは、MT5側の送信処理とGAS側の受信処理を分けて確認します。

確認したい項目は以下です。

  • MT5側で送信処理が実行されているか
  • 送信先URLが正しいか
  • 送信する項目名がGAS側の想定と一致しているか
  • GAS側でリクエストを受け取れているか
  • シートへ追記できているか
  • 書き込み先のシート名や列が正しいか
  • エラー時にMT5側へ結果が返る仕様か

書き込みができない場合、MT5側の送信失敗なのか、GAS側の受信失敗なのか、シートへの書き込み失敗なのかを分けて確認する必要があります。

8. 読み込み型連携で確認すること

Google Sheets側の設定値をMT5へ読み込むタイプでは、データ形式の確認が重要です。

確認する項目は以下です。

確認項目内容
公開URLMT5から取得できるURLか
取得結果空データではないか
列名EA側が期待する名前と一致しているか
値の形式ON/OFF、数値、時刻、文字列の形式が正しいか
更新反映シート変更後にMT5側へ反映されるタイミング
不正値空欄や想定外文字がある場合の扱い

読み込み型連携では、シート上で1文字だけ違っていても、EA側では不正値として扱われる場合があります。

9. Expertsログで確認したい項目

Google Sheets連携で不具合がある場合は、Expertsログを確認します。

確認できるとよい項目は以下です。

  • Google Sheets連携機能がONになっているか
  • WebRequest URLが空ではないか
  • 送信または取得を試みたか
  • HTTPステータスや通信失敗が出ていないか
  • レスポンスが空ではないか
  • GAS側からエラー応答が返っていないか
  • 取得したCSVやJSONを解析できたか
  • シート構造不一致のログがないか

ログ例として、以下のような項目が確認できると、どこで止まっているかを追いやすくなります。

SHEETS_SYNC_INIT: enabled=Y mode=WRITE url_status=SET
SHEETS_WRITE_REQUEST: target=TRADE_LOG rows=1
SHEETS_WRITE_RESULT: status=OK http=200
SHEETS_FETCH_REQUEST: source=CONTROL_CSV
SHEETS_FETCH_RESULT: status=OK bytes=1240
SHEETS_PARSE_FAIL: reason=MISSING_COLUMN column=allow_new_entry
SHEETS_SYNC_FAIL: reason=WEBREQUEST_NOT_ALLOWED
SHEETS_SYNC_SKIP: reason=DISABLED_BY_INPUT

上記は確認項目の例です。実際のログ名や表示形式は、使用しているEA、インジケータ、連携ツールの仕様によって異なります。

10. よくある原因と確認先

症状主な確認先確認内容
Sheetsへ書き込めないMT5 / GAS / SheetsWebRequest、GAS URL、デプロイ、書き込み権限
設定値を読み込めない公開URL / シート構造CSV公開、列名、空データ、不正値
以前は動いていたが止まったGAS / URL / 権限再デプロイ、URL変更、共有設定変更
一部の列だけ反映されないシート構造列名変更、列順変更、空欄、形式不一致
MT5側でエラーが出るExpertsログWebRequestエラー、レスポンス空、解析失敗
VPSでは動かないVPS環境通信状態、MT5設定差、URL登録漏れ

11. 問い合わせ前に整理しておく情報

Google Sheets連携の不具合を相談する場合は、MT5側、GAS側、シート側の情報を分けて整理すると確認が進めやすくなります。

項目整理する内容
使用ツールEA名、インジケータ名、Google Sheets連携ツール名
連携方式書き込み型、読み込み型、両方、手動CSV
MT5設定WebRequest許可、URL登録、外部連携ON/OFF
GAS設定デプロイ状態、URL更新、実行権限
シート設定シート名、列名、共有権限、保護設定
発生症状書き込めない、読み込めない、一部だけ反映されないなど
ログExpertsログ、Journalログ、GAS側の実行ログ
直前の変更URL変更、GAS再デプロイ、列変更、EA更新、VPS変更

GAS URL、Webhook URL、APIキー、口座番号、個人情報などが含まれる場合は、必要に応じて一部をマスクしてください。

12. 注意したいこと

Google Sheets連携は、記録、確認、外部設定管理を補助するための仕組みです。

ただし、外部サービス、通信環境、シート権限、GASの状態に依存するため、常に通信や記録が成功することを保証するものではありません。

特に以下には注意してください。

  • GAS URLや公開URLを外部に公開しない
  • APIキーや認証情報を本文や問い合わせ文にそのまま貼らない
  • シートの列名やタブ名を不用意に変更しない
  • 運用中のシートと検証用シートを混同しない
  • 外部設定をEAへ反映する場合は、反映範囲を理解してから使う
  • 通信失敗時の挙動を事前に確認する

外部シートでEAの設定値を管理する場合でも、最終的な設定確認は利用者側で行う必要があります。

Google Sheets連携であわせて確認したい記事:Google Sheets連携では、WebRequest設定、GAS URL、CSV公開URL、シート構造、外部シート設定の反映状況、Expertsログを分けて確認する必要があります。

13. まとめ

Google Sheets連携ツールを使う前には、MT5のWebRequest設定、GAS URL、デプロイ状態、共有権限、シート構造、EA側の入力項目、Expertsログを確認することが重要です。

書き込み型連携では、MT5からGASへ送信できているか、GASが受信しているか、シートへ書き込めているかを分けて確認します。読み込み型連携では、公開URL、列名、値の形式、不正値、反映タイミングを確認します。

EAファンクラブでは、MT4/MT5向けのGoogle Sheets連携ツール、WebRequestチェックツール、ログ確認補助ツール、CSV出力ツールなどについて、用途や環境に合わせた開発・改修相談を扱っています。

Google Sheets連携やWebRequest設定でお困りの場合は、使用環境、GAS URLの状態、シート構造、Expertsログを整理したうえでご相談ください。

当サイトでは、投資助言、相場予測、売買判断、特定ブローカーへの誘導は行っていません。ご相談は、MT4/MT5・MQL4/MQL5の開発・設定・検証・不具合調査に関する内容に限ります。

関連ページ

ABOUT ME
記事URLをコピーしました