FXMacroData を Google Apps スクリプトと Google シーツで使う方法

Google Sheets はマクロアナリストのスクラッチパッドです.更新が迅速で共有が簡単で,すでにGoogleの他のワークスペースに接続されています. Google Apps スクリプト Sheets の内蔵 JavaScript ランタイム は,ブラウザを離さずにスプレッドシートから任意の REST API を呼び出すことができます.このガイドでは,FXMacroData の発表データを Sheets タブに引き込むことを説明します. UrlFetchAppマクロダッシュボードが手動の介入なしに更新されるように,自動更新をスケジュールします. 自動更新は,マクロダシュボードの動作を調整します.

ステップ 1 Googleシートを作成して Apps スクリプトエディタを開きます

オープン シーツ.グーグル.com 書き換えると,このページの名前が FXMacroData ダッシュボード脚本編集を開きます

1. クリック 拡張 上のメニューバーに
2. 選択する アプリスクリプトわかった
3. 編集者は新しいタブで開きます. Code.gs ファイル
4. プロジェクト (左上のフィールド) の名前を変更します FXMacroData ロードヤー 明確になるため

サーバー側でGoogleのインフラストラクチャで実行されます 完全にアクセスできます UrlFetchApp 計算表を読み書きできる SpreadsheetApp サービス

ステップ2 復試論理を持つ取得ヘルパーを書く

入力してください Code.gs補完機能が入れ替わります この補完プログラムが UrlFetchApp.fetch 短時間の速度の制限応答は 実行全体を破壊しないようにします.

/**
 * Fetches a FXMacroData endpoint with automatic retry and exponential back-off.
 *
 * @param {string} currency  - e.g. "usd", "eur", "chf"
 * @param {string} indicator - e.g. "policy_rate", "gdp", "inflation"
 * @returns {Object|null}    - Parsed JSON response, or null on permanent failure
 */
function fetchAnnouncement(currency, indicator) {
  const apiKey = PropertiesService.getScriptProperties()
                   .getProperty('FXMACRODATA_API_KEY') || '';
  const url = `https://fxmacrodata.com/api/v1/announcements/${currency}/${indicator}`
              + (apiKey ? `?api_key=${apiKey}` : '');

  const maxRetries = 4;
  let delay = 1000; // 1 second initial back-off

  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      const response = UrlFetchApp.fetch(url, { muteHttpExceptions: true });
      const status = response.getResponseCode();

      if (status === 200) {
        return JSON.parse(response.getContentText());
      }

      if (status === 429) {
        // Rate limited — honour the back-off and retry
        Logger.log(`Rate limited on attempt ${attempt}. Waiting ${delay}ms.`);
        Utilities.sleep(delay);
        delay *= 2; // exponential back-off
        continue;
      }

      if (status === 404) {
        Logger.log(`No data for ${currency}/${indicator} (404). Skipping.`);
        return null;
      }

      // Other non-retryable errors
      Logger.log(`HTTP ${status} for ${currency}/${indicator}.`);
      return null;

    } catch (e) {
      Logger.log(`Network error on attempt ${attempt}: ${e.message}`);
      Utilities.sleep(delay);
      delay *= 2;
    }
  }

  Logger.log(`Permanently failed after ${maxRetries} attempts: ${currency}/${indicator}`);
  return null;
}

このヘルパーに注目すべき点は

• muteHttpExceptions: true 状態コードが表示され,どうするか決めることができます.
• メールの送信 税金 (RECOMMENDATIONS TOO MANY) は,遅延を倍にする再試行を誘発する.FXMacroDataは,キー毎のレート制限を強制する.控えめなバックオフ戦略は,完全な指標スイープを通じてスクリプトを予算内に保持する.
• メールの送信 ポイント 補助者が返信する null 順番をクリーンに跳ねました
• Logger.log 画面の下には 閲覧 → ログ 簡単にデバッグできます. 簡単に,簡単に,簡単です.

ステップ3 JSON応答をスプレッドシート行に標準化

FXMacroData 発表エンドポイントは,通貨/指標ペアごとに単一のオブジェクトを返します.有用なスプレッドシートを構築するには,リクエストリストを一貫した行構造に平ら化する必要があります.以下の標準化関数を下に追加します. fetchAnnouncementありがとうございました

/**
 * Converts a FXMacroData announcement response object into a flat array
 * suitable for appending as a single Sheets row.
 *
 * Columns: Timestamp, Currency, Indicator, Value, Prior, Consensus,
 *          Announcement DateTime, Direction
 *
 * @param {Object} data - Parsed JSON from fetchAnnouncement()
 * @returns {Array}     - Flat row array
 */
function toRow(data) {
  if (!data) return null;

  const direction =
    data.val > data.prior  ? 'Beat'  :
    data.val < data.prior  ? 'Miss'  : 'In line';

  return [
    new Date().toISOString(),          // Run timestamp
    (data.currency  || '').toUpperCase(),
    (data.indicator || '').replace(/_/g, ' '),
    data.val        ?? '',
    data.prior      ?? '',
    data.consensus  ?? '',
    data.announcement_datetime || '',
    direction
  ];
}

ほら announcement_datetime FXMacroDataのフィールドは,中央銀行または統計機関が読み上げを公開した正確な瞬間を2番目のレベルに準拠しています. そのタイムスタンプは,デュプリケーションキーとして理想的です.このタイムスタンプルを持つ行が既にシート内に存在するかどうかを確認し,追加する前に,繰り返される行に重複する行を防ぐことができます.

ステップ4 データをGoogleシートタブに書き込む

通貨/指標ペアのリストを繰り返す 呼び出し fetchAnnouncement変換する toRowページのタブに列を添付する.

/**
 * Defines the currency/indicator pairs to track.
 * Extend this list to cover additional signals for your strategy.
 */
const INDICATORS = [
  { currency: 'usd', indicator: 'policy_rate' },
  { currency: 'usd', indicator: 'inflation' },
  { currency: 'usd', indicator: 'non_farm_payrolls' },
  { currency: 'eur', indicator: 'policy_rate' },
  { currency: 'eur', indicator: 'inflation' },
  { currency: 'chf', indicator: 'gdp' },
  { currency: 'chf', indicator: 'consumer_confidence' },
  { currency: 'chf', indicator: 'gov_bond_10y' },
  { currency: 'gbp', indicator: 'policy_rate' },
  { currency: 'gbp', indicator: 'inflation' },
];

const SHEET_NAME = 'MacroData';
const HEADERS    = [
  'Run Timestamp', 'Currency', 'Indicator', 'Value',
  'Prior', 'Consensus', 'Announcement DateTime', 'Direction'
];

/**
 * Main entry point — fetches all configured indicators and
 * appends new rows to the MacroData sheet tab.
 */
function loadMacroData() {
  const ss    = SpreadsheetApp.getActiveSpreadsheet();
  let   sheet = ss.getSheetByName(SHEET_NAME);

  // Create the tab if it does not exist yet
  if (!sheet) {
    sheet = ss.insertSheet(SHEET_NAME);
    sheet.appendRow(HEADERS);
    sheet.getRange(1, 1, 1, HEADERS.length)
         .setFontWeight('bold')
         .setBackground('#1a73e8')
         .setFontColor('#ffffff');
    sheet.setFrozenRows(1);
  }

  // Build a set of existing announcement_datetimes to avoid duplicates
  const lastRow  = sheet.getLastRow();
  const existing = new Set();
  if (lastRow > 1) {
    const dtCol = 7; // "Announcement DateTime" is column 7 (index 6, 1-based col 7)
    const values = sheet.getRange(2, dtCol, lastRow - 1, 1).getValues();
    values.forEach(([dt]) => { if (dt) existing.add(String(dt)); });
  }

  const newRows = [];

  INDICATORS.forEach(({ currency, indicator }) => {
    // Throttle requests — 200 ms between calls keeps well within rate limits
    Utilities.sleep(200);

    const data = fetchAnnouncement(currency, indicator);
    const row  = toRow(data);

    if (!row) return; // skip null / error responses

    const announcementDt = row[6]; // announcement_datetime column
    if (existing.has(announcementDt)) {
      Logger.log(`Skipping duplicate: ${currency}/${indicator} @ ${announcementDt}`);
      return;
    }

    newRows.push(row);
    existing.add(announcementDt); // guard against duplicates within the same run
  });

  if (newRows.length > 0) {
    sheet.getRange(sheet.getLastRow() + 1, 1, newRows.length, HEADERS.length)
         .setValues(newRows);
    Logger.log(`Appended ${newRows.length} new row(s) to "${SHEET_NAME}".`);
  } else {
    Logger.log('No new rows — all announcements already present.');
  }
}

逃げろ loadMacroData 編集から手動で (クリック) ▶ 走れ実行する際に,スクリプトを承認するように要求されます. 閲覧 → 許可する スプレッドシートと外部ネットワークのリクエストへのアクセスを許可する.

function resetSheet() {
  const ss    = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(SHEET_NAME);
  if (sheet) ss.deleteSheet(sheet);
  loadMacroData(); // recreates with fresh headers and data
}

ステップ 5 幅の大きい指標のスイープでレート制限を調整する

ステップ4の 200 ms 間のリクエスト遅延は,上記の10 つの指標リストに十分である. 50 つ以上のペアに拡大した場合,全発表カタログの複数の通貨をカバーする,より意図的な絞め込みを実施する必要があります. カウンターベースの休憩で恒常的な睡眠を置き換える:

/**
 * Fetches a larger list of indicators with adaptive throttling.
 * Pauses for 1 second every 10 requests to respect rate limits.
 */
function loadMacroDataBulk(indicators) {
  const ss    = SpreadsheetApp.getActiveSpreadsheet();
  let   sheet = ss.getSheetByName(SHEET_NAME) || (() => {
    const s = ss.insertSheet(SHEET_NAME);
    s.appendRow(HEADERS);
    s.getRange(1, 1, 1, HEADERS.length)
     .setFontWeight('bold')
     .setBackground('#1a73e8')
     .setFontColor('#ffffff');
    s.setFrozenRows(1);
    return s;
  })();

  const newRows = [];
  let   count   = 0;

  indicators.forEach(({ currency, indicator }) => {
    count++;

    // Longer pause every 10 requests
    if (count % 10 === 0) {
      Logger.log(`Pausing after ${count} requests…`);
      Utilities.sleep(1500);
    } else {
      Utilities.sleep(150);
    }

    const data = fetchAnnouncement(currency, indicator);
    const row  = toRow(data);
    if (row) newRows.push(row);
  });

  if (newRows.length > 0) {
    sheet.getRange(sheet.getLastRow() + 1, 1, newRows.length, HEADERS.length)
         .setValues(newRows);
  }
  Logger.log(`Bulk load complete — ${newRows.length} rows appended.`);
}

FXMacroDataの発表エンドポイントは高速です.各応答は通常,Google Apps スクリプト実行環境から100ms未満で返信されます.大規模なスイープにおける主なボトルネックは,遅延ではなく,キーごとに要求する予算です. Utilities.sleep ブロックやキャッシュの論理なしでプランの限界内に留まる最も簡単な方法です.

ステップ6 タイム駆動トリガーで自動更新をスケジュールする

脚本が使われています 誘発器 プログラム化して,次のヘルパーは平日の朝のトリガーを作成します. 編集者から一度実行して登録し,ヘルパーの自体を削除します.

/**
 * Registers a time-driven trigger that runs loadMacroData()
 * every weekday between 07:00 and 08:00 UTC.
 *
 * Run this function ONCE from the Apps Script editor to set up the trigger.
 * You do not need to call it again — it persists in the project.
 */
function createWeekdayTrigger() {
  // Remove any existing triggers for loadMacroData to avoid duplicates
  ScriptApp.getProjectTriggers()
    .filter(t => t.getHandlerFunction() === 'loadMacroData')
    .forEach(t => ScriptApp.deleteTrigger(t));

  ScriptApp.newTrigger('loadMacroData')
    .timeBased()
    .everyWeeks(1)
    .onWeekDay(ScriptApp.WeekDay.MONDAY)
    .atHour(7)
    .create();

  // Also register Tuesday through Friday
  [
    ScriptApp.WeekDay.TUESDAY,
    ScriptApp.WeekDay.WEDNESDAY,
    ScriptApp.WeekDay.THURSDAY,
    ScriptApp.WeekDay.FRIDAY,
  ].forEach(day => {
    ScriptApp.newTrigger('loadMacroData')
      .timeBased()
      .everyWeeks(1)
      .onWeekDay(day)
      .atHour(7)
      .create();
  });

  Logger.log('Weekday triggers registered for loadMacroData.');
}

走った後 createWeekdayTriggerオープン 誘発器 (エディタの左サイドバーのアラームベルアイコン) 確認するには,5つのトリガーが表示されます. ※各週日ごとに1つ.各トリガーは,Googleアカウントで設定された時間帯で07:00~08:00の間に行われます.

ステップ 7 公開カレンダーをイベント日によって前フィルタに取得

ほら /v1/calendar/{currency} endpoint は,通貨の予定されたリリースを返します. 月曜日にそれを使って,その週の発表日付をセットを作成し,イベントのない日に取得ステップをスキップします.

/**
 * Returns a Set of date strings ("YYYY-MM-DD") for which at least one
 * high-impact announcement is scheduled this week for the given currency.
 *
 * @param {string} currency - e.g. "usd"
 * @returns {Set} */関数 getAnnouncementDatesThisWeek(currency) { const apiKey = PropertiesService.getScriptProperties() .getProperty (('FXMACRODATA.getCode.getResponse.API_KEY') '; const url = https://fxmacrodata.com/api/v1/calendar/${currency}` + (apiKey ? `(((?api_key=${apiKee}` : ' '); const response = UrlFetch mute.Appfetchurl, {HttpExceptions: true }); if (response.getCalCode) } .getCopy = new Set (); const const const rest = 200; const rest () = new set (); rest () () = JSON (https: //fxmACROData.getAPI_Key') '); rest rest = rest () {date.getMacdate.getContent.get () }; const const ur l = ${current loaddate.date.net} }; rest = new load (date.comment); rest = current load (data.completext); rest (data) = new dates); rest {date.) = current (data).getData.date).get (data.) }; //get (date.) } (data); rest: ${date.data.date); rest) = current; rest (date).); rest ((date.const) = 'date); 'date.today'); rest; 'date (date); } } (date) } (today); 'today) (date (todays); '); 'event); 'evening); 'day (todday); 'end); 'sday); } (day); (date}.} (date} (todadvanceased); '; 'todays) (todidate); ' (date; 'events); 'new); 'date); (todate); ('events). (date'; 'date). (events.date) (event.date;'); 'This week (date)). (date today) (date) (day) (s) (new); (eventially) (if (date), (if) (evenant) (

このパターンを使うには 登録してください loadMacroDataCalendarAware 引き金を引く代わりに loadMacroData 函数名文字列を に置き換える createWeekdayTrigger 適正に

概要

ソフトウェアスクリプトでFXMacroDataとGoogleシートを接続します. ソフトウェアの作成は,

• 復試と指数関数バックオフの 呼び出すヘルパーで 臨時的なネットワークエラーと速度制限応答を 優雅に処理します
• 標準化関数で,各発表応答を一貫したデデュプリケーション安全のスプレッドシート行に変換する.
• プレスリリースでヘッダを作成し,新しいリリースのみを追加し,以前見ていたものをスキップします announcement_datetime 価値
• 適応型ストロッシング 貨幣/指標ペアを数十種類を対象とした大量スイープ
• 完全自動化された日々の更新のための平日の時間駆動トリガーです
• 予定されていない日に冗長な API コールを避けるオプションのカレンダープレチェック.