朝起きてカーテンを開けた瞬間、外が一面の銀世界に変わっていて「あ、今日は少し早めに家を出てチカホ経由でオフィスに向かおうかな」「JR快速エアポートは平常運転しているかな?」と、スマホで天気予報や交通情報アプリを慌ててチェックする……。道民なら誰しも冬の朝に一度は経験する日常のワンシーンですよね。
社内の業務でも、「今日の現場の天候や気温を日報に記録したい」「札幌オフィスのダッシュボードに、最新の天気や交通のアラートを自動で表示させたい」といった要望は本当によくあります。しかし、毎朝人間が手作業でWebサイトを見に行き、気温や降雪確率をスプレッドシートへポチポチ転記していたら、せっかくの朝の貴重な時間が奪われてしまいますし、何より面倒ですよね。
そんなときに大活躍するのが、GAS(Google Apps Script)からインターネット上のあらゆるWebサービスと通信できる最強の標準サービス、UrlFetchApp.fetch()(ユーアールエル・フェッチ・アップ・フェッチ)です!
前回(第93回)は、大切なAPIキーやパスワードを安全に隠して保管する PropertiesService.getScriptProperties() を学びました。金庫に秘密の鍵をしまえたところで、今回はいよいよその鍵やオープンなWebデータを活用し、外部のサーバーからリアルタイムな最新情報をGASへ引っ張ってくる「HTTP GET通信」の世界へと足を踏み入れます!
Web APIの基本的な仕組みから、UrlFetchApp.fetch() の基本構文、取得したデータの解凍手順、札幌オフィスの統合ダッシュボードへリアルタイムに気象データを組み込む実践テクニック、そして初心者が必ず直面する「通信エラーの罠」まで、どこよりも分かりやすく丁寧に解説していきますね!
1. そもそも UrlFetchApp.fetch() とは?外部と通信する「専用ブラウザ」の仕組み
まずは、「GASが外部のWebサービスと通信するとはどういうことなのか?」という根本的な仕組みから紐解いていきましょう。
プログラムの中に住んでいる「全自動のWebブラウザ」
普段、私たちがパソコンやスマートフォンで天気予報や電車の運行状況を見るときは、Google ChromeやSafariなどの「Webブラウザ」を開いてURLを入力し、Enterキーを押しますよね。すると、相手のサーバーから画面のデータが送られてきて、ブラウザ上に表示されます。
GASの世界で、このブラウザの役割をプログラムの中で全自動で代行してくれるのが UrlFetchApp.fetch() です!
「fetch(フェッチ)」には英語で「(行って)取ってくる」という意味があります。GASのプログラムに対して「指定したURLのWebサーバーまで飛んでいって、そこに置いてある最新データを取ってきて!」とお使いを頼む命令なのです。
「注文カウンター(Web API)」のイメージで理解しよう!
インターネット上には、人間が見るためのカラフルなWebサイトだけでなく、プログラム同士がデータをやり取りするための専用の注文窓口が用意されています。この仕組みを Web API(ウェブ・エーピーアイ) と呼びます。
| 比較項目 | 人間がWebを見る場合 | GASがWeb APIを使う場合(★今回) |
|---|---|---|
| 使うツール | Google Chrome / Safariなどのブラウザ | GASの UrlFetchApp.fetch() |
| アクセス先 | 一般的なWebページのURL(HTML) | Web APIの専用URL(エンドポイント) |
| 返ってくるデータ | カラフルに装飾されたWeb画面 | 余計な飾りのない純粋なデータ(主にJSON) |
| 目的 | 目で見て楽しむ・読む | プログラムで計算したり、シートに保存する |
例えば、気象データを提供しているサーバーのAPI窓口に向かって、GASが UrlFetchApp.fetch("https://.../weather?city=sapporo") と呼びかけると、相手のサーバーは「はい、現在の札幌の天気は晴れ、気温は18.5度ですよ!」と、機械が一番読み取りやすい形でデータを手渡してくれます。
2. GETリクエストの構造と仕組みを完全マスター
前回までのWebアプリ編(第81回〜第90回)で、Webの通信には「GET(ちょうだい)」と「POST(これ登録して)」の2大巨頭があることを学びましたね。
GET通信=「データの取得・読み取り」専用のリクエスト
今回扱うのは、外部のサーバーからデータを取ってくるための GETリクエスト です。
UrlFetchApp.fetch() は、オプションを何も指定せずにURLだけを渡すと、自動的に「GETリクエスト」として通信を行う仕様 になっています。そのため、たった1行書くだけで外部サーバーからデータを引き出すことができるのです!
// 最もシンプルな GETリクエストの基本形
var response = UrlFetchApp.fetch("アクセスしたいAPIのURL");
戻り値は「HTTPResponse(小包)」で返ってくる!
ここが初心者が一番つまずきやすい超重要ポイントです!
UrlFetchApp.fetch() を実行して返ってくる response という変数には、いきなり「気温の数値」や「天気の文字」が直接入っているわけではありません。
返ってくるのは、通信結果がまるごと梱包された HTTPResponse オブジェクト(通信の小包箱) です!
| 取り出したい情報 | 使用するメソッド | 取得できる内容・役割 |
|---|---|---|
| 中身のテキスト(本文) | response.getContentText() | 相手から届いたデータ(JSON文字列など)を解凍して取り出す【★最重要】 |
| 通信ステータス番号 | response.getResponseCode() | 通信が成功したかを表す数字(200なら成功、404なら見つからない等) |
| 通信ヘッダー情報 | response.getHeaders() | データの形式や通信日時などのメタ情報 |
「小包(response)を受け取ったら、ハサミを入れて getContentText() で中身の書類(テキスト)を取り出す」という2段階の手順を意識しておきましょう!
3. STEP1:準備!登録不要・完全無料で使える「札幌気象データAPI」を用意しよう
それでは、実際にGASから通信をテストするための準備をしていきましょう!
外部APIを学ぶとき、多くの人が「事前のユーザー登録やクレジットカード登録がめんどくさい……」「APIキーの発行でつまずいて挫折した」という壁にぶつかります。そこで今回は、会員登録一切不要・APIキーも不要・商用利用も可能な世界基準のオープン気象API「Open-Meteo(オープン・メテオ)」 を使って、札幌のリアルタイムデータを取得します!
札幌の座標(緯度・経度)とAPIのURLを確認しよう
Open-Meteoは、緯度(latitude)と経度(longitude)を指定するだけで、世界中のあらゆる地点の現在の気温、風速、天気コードなどを高精度なJSON形式で返してくれる非常に優秀なAPIです。
- 札幌市の中心地座標(札幌時計台・大通公園周辺):
- 緯度(latitude):
43.0642 - 経度(longitude):
141.3469
- 緯度(latitude):
- タイムゾーン:
Asia/Tokyo(日本標準時)
これらを組み合わせた、今回アクセスする「札幌気象API」のURLがこちらです!
https://api.open-meteo.com/v1/forecast?latitude=43.0642&longitude=141.3469¤t_weather=true&timezone=Asia%2FTokyo
気になった方は、上記のURLをコピーしてブラウザのアドレスバーに貼り付けてEnterを押してみてください。画面に英数字が詰まったテキスト(JSONデータ)がズラリと表示されるはずです。この生データを、今回はGASのプログラムから一瞬で取ってきます!
4. STEP2:【実践】UrlFetchApp.fetch() で札幌のリアルタイム天気を取得してみよう!
準備ができたところで、さっそくGASのエディタを開いて、外部APIへGETリクエストを送信する基本コードを書いてみましょう!
1. GASエディタを開く
これまでの連載で使用してきたGoogleスプレッドシート「札幌オフィス統合管理簿」(または新規作成したスプレッドシート)を開き、上部メニューバーの 「拡張機能」 > 「Apps Script」 をクリックしてエディタを開きます。
2. コードを入力する
エディタ内の既存コードをすべて消去し、以下のスクリプトを貼り付けてください。
/**
* 第94回 STEP2:UrlFetchApp.fetch() によるGET通信の基本
* 外部API(Open-Meteo)から札幌の現在の天候・気温データを取得する
*/
function fetchSapporoWeather() {
// ① 札幌の気象情報APIのエンドポイントURLを準備
var apiUrl = "https://api.open-meteo.com/v1/forecast?latitude=43.0642&longitude=141.3469¤t_weather=true&timezone=Asia%2FTokyo";
Logger.log("=== 外部APIへの通信を開始します ===");
// ② 【本日の主役!】UrlFetchApp.fetch() でGETリクエストを送信!
var response = UrlFetchApp.fetch(apiUrl);
// ③ 通信ステータスコードを確認(200なら通信成功!)
var statusCode = response.getResponseCode();
Logger.log("■ HTTPステータスコード : " + statusCode);
// ④ 小包の中から本文(JSON文字列)を取り出す
var rawText = response.getContentText();
Logger.log("■ 取得した生のレスポンスデータ : ");
Logger.log(rawText);
}
3. 保存と初回実行(アクセス承認)
コードが貼り付けられたら、エディタ上部の 「保存(フロッピーアイコン)」 をクリックし、実行する関数が fetchSapporoWeather になっていることを確認して 「実行」 ボタンを押します。
初めて UrlFetchApp を使うプロジェクトでは、「このアプリが外部サービスへの接続権限を求めています」というGoogleの承認ポップアップが表示されます(第2回で学んだ手順です!)。「権限を確認」>「詳細」>「安全ではないページに移動」>「許可」の順に進めてアクセスを承認してください。
4. 実行ログを確認してみよう!
実行が完了したら、画面下部の「実行ログ」を確認してみましょう!
情報 === 外部APIへの通信を開始します ===
情報 ■ HTTPステータスコード : 200
情報 ■ 取得した生のレスポンスデータ :
情報 {"latitude":43.0625,"longitude":141.375,"generationtime_ms":0.04100799560546875,"utc_offset_seconds":32400,"timezone":"Asia/Tokyo","timezone_abbreviation":"JST","elevation":25.0,"current_weather":{"time":"2026-11-03T15:00","interval":900,"temperature":14.8,"windspeed":12.5,"winddirection":310,"is_day":1,"weathercode":3}}
たった1行 UrlFetchApp.fetch(apiUrl) を書いただけなのに、外部の気象サーバーから現在の札幌のリアルタイムな気象データが手元のGASへと一瞬で吸い込まれてきました!感動的ですよね!
5. STEP3:レスポンスを解析して「気温」と「お天気マーク」を取り出そう!
生データが取れたのは素晴らしいですが、このままだと "temperature":14.8 や "weathercode":3 といった文字がぎっしり詰まっていて、人間には少し見づらいですよね。
そこで、届いた文字列をJavaScriptで扱いやすい形に変換し、「現在の札幌の気温」と「天気の解説文」をスマートに取り出すロジックを組み込んでみましょう!
天気コード(Weather Code)を日本語と絵文字に変換する辞書
世界気象機関(WMO)の基準では、天候が数字のコード(0〜99)で表されます。札幌のオフィスで使いやすいように、代表的なコードを変換する辞書オブジェクトを用意します。
| 天気コード(weathercode) | 天候の意味 | ダッシュボード用絵文字アイコン |
|---|---|---|
0 | 快晴(Clear sky) | ☀️ 快晴 |
1, 2, 3 | 晴れ 〜 曇りがち | ⛅ 晴れ時々曇り / ☁️ 曇り |
45, 48 | 霧・濃霧(朝の定山渓など) | 🌫️ 霧 |
51 〜 65 | 小雨 〜 本降りの雨 | 🌧️ 雨 |
71 〜 77 | 雪・粉雪(札幌の冬の主役!) | ⛄ 雪(足元注意・除雪準備!) |
80 〜 82 | にわか雨・土砂降り | 🌦️ 通り雨 |
85, 86 | 吹雪・大雪(交通障害警戒) | ❄️ 吹雪・猛吹雪(チカホ推奨!) |
95 〜 99 | 雷雨・嵐 | ⚡ 雷雨 |
解析コードを動かしてみよう!
以下のコードをエディタに追加して実行してみましょう。
/**
* 札幌の気象データを解析して、人間が読みやすい形式に整形する
*/
function parseSapporoWeather() {
var apiUrl = "https://api.open-meteo.com/v1/forecast?latitude=43.0642&longitude=141.3469¤t_weather=true&timezone=Asia%2FTokyo";
// 1. APIから小包を取得
var response = UrlFetchApp.fetch(apiUrl);
// 2. 本文テキストを取り出し、JSONオブジェクトに変換(次回の第95回でさらに深掘り!)
var json = JSON.parse(response.getContentText());
// 3. current_weather の中から必要な数値を取り出す
var currentWeather = json.current_weather;
var temp = currentWeather.temperature; // 気温(℃)
var windSpeed = currentWeather.windspeed; // 風速(km/h)
var weatherCode = currentWeather.weathercode; // 天気コード
var recordTime = currentWeather.time; // 観測時刻
// 4. 天気コードを日本語&絵文字に変換
var weatherText = getWeatherDescription(weatherCode);
// 5. ログに出力して確認!
Logger.log("==========================================");
Logger.log("🏢 札幌オフィス周辺 リアルタイム気象レポート");
Logger.log("・観測日時 : " + recordTime);
Logger.log("・天候状況 : " + weatherText);
Logger.log("・現在気温 : " + temp + " ℃");
Logger.log("・風速 : " + windSpeed + " km/h");
Logger.log("==========================================");
}
/**
* WMO天気コードを札幌オフィス向けの分かりやすいテキストに変換する関数
*/
function getWeatherDescription(code) {
if (code === 0) return "☀️ 快晴(お出かけ・外回り日和)";
if (code >= 1 && code <= 3) return "⛅ 晴れ時々曇り";
if (code === 45 || code === 48) return "🌫️ 霧(視界に注意)";
if (code >= 51 && code <= 65) return "🌧️ 雨(傘をお持ちください)";
if (code >= 71 && code <= 77) return "⛄ 雪(冬靴・足元注意!)";
if (code === 85 || code === 86) return "❄️ 猛吹雪(JR・交通機関の遅延警戒 / チカホ利用推奨)";
if (code >= 95) return "⚡ 雷雨(急な悪天候に注意)";
return "☁️ 曇り";
}
実行ログを見てみると……!
情報 ==========================================
情報 🏢 札幌オフィス周辺 リアルタイム気象レポート
情報 ・観測日時 : 2026-11-03T15:00
情報 ・天候状況 : ⛅ 晴れ時々曇り
情報 ・現在気温 : 14.8 ℃
情報 ・風速 : 12.5 km/h
情報 ==========================================
生の数字の羅列だったJSONデータが、誰が見ても一目で状況が伝わるスマートな気象レポートへと生まれ変わりました!
6. STEP4:【本格実践】取得したお天気データを「札幌オフィス統合ダッシュボード」に表示しよう!
ここまでの知識を総動員して、フェーズ9で作成した「札幌オフィス統合ダッシュボード(Webアプリ)」のトップ画面に、リアルタイムな札幌の天気・交通アラートウィジェットを合体させてみましょう!
1. バックエンド(コード.gs)にお天気取得処理を組み込む
Webアプリの表示関数 doGet(e)(第81回〜第85回参照)の中でAPIを呼び出し、取得した気象データをHTMLテンプレートへ手渡します。
/**
* 札幌オフィス統合ダッシュボード Webアプリケーション
* 天気APIからリアルタイム情報を取得して画面に描画する
*/
function doGet(e) {
// ① 外部APIから現在の札幌の天気を取得
var weatherInfo = getLiveSapporoWeather();
// ② HTMLテンプレートを読み込む(第84回の復習!)
var template = HtmlService.createTemplateFromFile('index');
// テンプレートへ最新のお天気オブジェクトを手渡す!
template.weather = weatherInfo;
template.syncTime = Utilities.formatDate(new Date(), "Asia/Tokyo", "HH:mm");
// ③ 画面を出力
var htmlOutput = template.evaluate();
htmlOutput.setTitle('【札幌オフィス】リアルタイム統合ポータル');
htmlOutput.addMetaTag('viewport', 'width=device-width, initial-scale=1');
return htmlOutput;
}
/**
* 外部API(Open-Meteo)を叩いて札幌の気象サマリーを作成するヘルパー関数
*/
function getLiveSapporoWeather() {
var apiUrl = "https://api.open-meteo.com/v1/forecast?latitude=43.0642&longitude=141.3469¤t_weather=true&timezone=Asia%2FTokyo";
try {
var response = UrlFetchApp.fetch(apiUrl, { muteHttpExceptions: true });
if (response.getResponseCode() === 200) {
var json = JSON.parse(response.getContentText());
var current = json.current_weather;
var temp = Math.round(current.temperature * 10) / 10; // 小数点第1位に丸める
var code = current.weathercode;
// 交通・移動のアドバイスコメントを自動生成
var transitComment = "地下鉄・JRともに平常運行中。快適に移動できます。";
var alertLevel = "normal"; // normal, warning, danger
if (code >= 71 || current.windspeed >= 25) {
transitComment = "⚠️ 降雪または強風を検知。JR快速エアポートの遅れに注意。チカホ直結ルートをご利用ください。";
alertLevel = "warning";
}
return {
success: true,
temp: temp,
desc: getWeatherDescription(code),
wind: current.windspeed,
transit: transitComment,
alertLevel: alertLevel
};
}
} catch (e) {
Logger.log("気象API通信エラー: " + e.message);
}
// 万が一APIが落ちていた場合の安全なフォールバックデータ
return {
success: false,
temp: "--",
desc: "☁️ データ取得中",
wind: "--",
transit: "運行情報は各社公式サイトをご確認ください。",
alertLevel: "normal"
};
}
2. フロントエンド(index.html)にお天気ウィジェットを追加する
index.html のメインコンテンツエリア上部に、以下のHTML/CSSカードを追加しましょう(第84回のスクリップレット <?= ... ?> を活用します!)。
<!-- index.html の一部:お天気&交通リアルタイムウィジェット -->
<style>
.weather-banner {
background: linear-gradient(135deg, #1a365d, #2b6cb0);
color: #ffffff;
border-radius: 10px;
padding: 20px 24px;
margin-bottom: 24px;
box-shadow: 0 4px 12px rgba(26, 54, 93, 0.15);
display: flex;
justify-content: space-between;
align-items: center;
flex-wrap: wrap;
gap: 16px;
}
.weather-main {
display: flex;
align-items: center;
gap: 16px;
}
.weather-temp {
font-size: 32px;
font-weight: 700;
}
.weather-detail {
font-size: 13px;
color: #e2e8f0;
line-height: 1.5;
}
.transit-card {
background: rgba(255, 255, 255, 0.12);
border-radius: 6px;
padding: 10px 14px;
font-size: 12px;
max-width: 360px;
line-height: 1.6;
border-left: 3px solid #63b3ed;
}
.transit-warning {
border-left-color: #dd6b20;
background: rgba(221, 107, 32, 0.25);
}
</style>
<div class="weather-banner">
<div class="weather-main">
<div class="weather-temp"><?= weather.temp ?>℃</div>
<div class="weather-detail">
<div style="font-weight: bold; font-size: 15px;"><?= weather.desc ?></div>
<div>風速: <?= weather.wind ?> km/h | 札幌中心部観測(<?= syncTime ?> 同期)</div>
</div>
</div>
<div class="transit-card <?= (weather.alertLevel === 'warning') ? 'transit-warning' : '' ?>">
<strong>🚇 札幌交通・アクセス速報:</strong><br>
<?= weather.transit ?>
</div>
</div>
3. 開発用テストURL(/dev)で確認してみよう!
エディタ右上の「デプロイ」>「デプロイをテスト」からテスト用URLを開いてみてください。
ダッシュボードの最上部に、深みのある札幌ネイビーの美しいバナーが現れ、「現在の札幌のリアルタイム気温」「お天気アイコン」「交通アドバイス」 がパッと表示されたはずです!
画面をリロードするたびにGASが裏側で自動通信して最新情報を取ってきてくれるため、毎朝ダッシュボードを開くだけで、札幌オフィスのスタッフ全員が即座に外の天候と交通事情を共有できるようになりました。
7. STEP5:第93回の伏線回収!シークレットキーが必要な外部APIと安全に通信する方法
「今回は登録不要のAPIを使ったけれど、仕事でよくある『秘密のAPIキー(アクセストークン)』が必要な外部サービスと通信するときはどう書けばいいの?」
ここで、前回(第93回)で学んだ PropertiesService.getScriptProperties() の出番です!
例えば、OpenWeatherMapなどの有料・商用気象APIや、社内のプライベートAPIサーバーを叩くときは、URLの末尾に &appid=APIキー を添えて通信する仕様が一般的です。このとき、コードの中に直接キーを書くのではなく、金庫から取り出してURLを組み立てるのがプロの現場の鉄則です。
/**
* 第93回のスクリプトプロパティを活用して、認証が必要な外部APIを叩くプロの書き方
*/
function fetchPrivateApiWithSecretKey() {
// ① 第93回で学んだ金庫から秘密のキーを安全に取り出す!
var scriptProperties = PropertiesService.getScriptProperties();
var apiKey = scriptProperties.getProperty("WEATHER_API_KEY");
if (!apiKey) {
throw new Error("金庫に WEATHER_API_KEY が登録されていません!");
}
// ② URLパラメータに安全にキーを合体させる
var endpoint = "https://api.example.com/v1/sapporo/weather";
var requestUrl = endpoint + "?city=sapporo&key=" + encodeURIComponent(apiKey);
// ③ GET通信を実行
var response = UrlFetchApp.fetch(requestUrl);
Logger.log("通信成功!: " + response.getContentText());
}
前回学んだ「金庫での秘匿管理」と今回の「UrlFetchApp」がカチッと噛み合いましたね!これなら、スクリプトをチームメンバーと共有しても、大切なAPIキーが流出する心配は一切ありません。
8. 実務で差がつく!UrlFetchApp.fetch() (GET) のプロ技3選
基本操作ができるようになったら、現場のシステム開発で必須となる3つの高度な通信オプションを押さえておきましょう!
プロ技①:HTTPエラー(404や500)でもスクリプトを止めない「muteHttpExceptions」
通常、UrlFetchApp.fetch() はアクセス先のサーバーがエラー(ページが見つからない404や、相手のサーバーがダウンしている500など)を返すと、その場で真っ赤なエラーを吐いてプログラム全体が強制終了 してしまいます。
これを防ぐための魔法のオプションが muteHttpExceptions: true です!
var options = {
"muteHttpExceptions": true // エラーが返ってきても強制停止させない!
};
var response = UrlFetchApp.fetch("https://example.com/api", options);
var code = response.getResponseCode();
if (code === 200) {
Logger.log("正常にデータを受信しました!");
} else {
Logger.log("通信相手でエラーが発生しています。HTTPステータス: " + code);
// エラー時でもスクリプトを止めず、予備の処理を安全に走らせることができる!
}
実務で運用する自動化ツールでは、この muteHttpExceptions: true を付けておくのがエンジニアの常識です。
プロ技②:Bearerトークンやカスタムヘッダーを添えて通信する
近年のセキュリティが厳しいWeb API(GitHubやNotion、外部SaaSなど)では、URLにキーをつけるのではなく、「HTTPリクエストヘッダー」に認証トークンを添えて送る方式が主流です。
var token = PropertiesService.getScriptProperties().getProperty("SAAS_API_TOKEN");
var options = {
"method": "get",
"headers": {
"Authorization": "Bearer " + token, // 認証トークン
"Accept": "application/json" // JSON形式で返してねというリクエスト
},
"muteHttpExceptions": true
};
var response = UrlFetchApp.fetch("https://api.example.com/v2/reports", options);
第2引数に headers オブジェクトを渡すことで、世界中のどんな本格的なWeb APIとも対等に通信できるようになります!
プロ技③:URLパラメータに日本語が含まれるときは「encodeURIComponent」を通す
「札幌市中央区」のように、URLのパラメータに日本語を含めて外部APIへリクエストを送りたい場合、そのままURLに日本語を混ぜると「Malformed URL(不正なURL)」としてエラーになります。
var city = "札幌市中央区";
// ✕ エラーになりやすい書き方
// var url = "https://api.example.com/search?q=" + city;
// ◯ 安全な書き方:URLエンコードを通す!
var url = "https://api.example.com/search?q=" + encodeURIComponent(city);
// ➔ "https://api.example.com/search?q=%E6%9C%AD%E5%B9%8C%E5%B8%82%E4%B8%AD%E5%A4%AE%E5%8C%BA"
9. 初心者が100%つまずく!UrlFetchApp (GET) の5大トラップと完全対処法
UrlFetchApp を使い始めた開発者が必ず一度は直面する「典型的な5大トラップ」をまとめました。通信がうまくいかないときは、まずここを確認してください!
トラップ1:response を直接オブジェクトだと思い込んでエラーになる
// ✕ 超危険!大間違いのコード
var response = UrlFetchApp.fetch(url);
var temp = response.temperature; // ➔ undefined!取れません!
// ◯ 正しい順序:小包を開けて ➔ JSON文字列をオブジェクトに変換する!
var response = UrlFetchApp.fetch(url);
var text = response.getContentText(); // まずテキストを取り出す
var json = JSON.parse(text); // JSONオブジェクトに変換
var temp = json.current_weather.temperature; // 完璧!
トラップ2:URLの先頭や末尾に「不要なスペース」が入っている
APIのURLをWebサイトからコピー&ペーストした際、末尾や先頭に半角スペースが混ざってしまうケースが非常に多いです。
スペースが1文字でも入っていると、GASは DNS error や Invalid argument: url というエラーを出して停止します。URLの文字列を " で囲むときは、前後に余計な空白がないか必ず目視でチェックしましょう!
トラップ3:GASの1日の通信制限(URL Fetch Quota)を超えてしまう
第39回でメール送信の上限(1日100通/1500通)を学びましたが、実は UrlFetchApp にも1日あたりの呼び出し回数制限(クォータ)が存在します。
- 無料Googleアカウント(@gmail.com):1日 20,000回 まで
- Google Workspace(有料法人アカウント):1日 100,000回 まで
通常は2万回もあれば十分ですが、スプレッドシートの1行ごとにループで UrlFetchApp.fetch() を何百回も連続で実行すると、あっという間に制限に達したり、相手のAPIサーバーから「アクセスが多すぎます(429 Too Many Requests)」と怒られてブロックされてしまいます。短時間に大量の通信を行う処理は避けましょう!
トラップ4:http://(非暗号化通信)にアクセスしてエラーになる
古いWebサイトや社内サーバーの中には、URLが http://(暗号化されていない通信)になっているものがあります。現代のGAS環境ではセキュリティ保護のため、原則として暗号化された https:// のURLへの通信が推奨されており、環境によってはブロックされる場合があります。可能な限り https:// で始まるAPIを利用しましょう。
トラップ5:相手のサーバーが落ちているとGASのWebアプリ全体が巻き込まれて真っ白になる
ダッシュボードを表示する doGet(e) の中で直接外部APIを叩く設計にしていると、もし相手の気象APIサーバーがメンテナンス等でダウンした瞬間に、あなたのダッシュボードまでエラーで開けなくなってしまいます。
【対策】STEP4のコードのように、外部API通信部分は必ず 第30回で学んだ try…catch で囲み、万が一通信が失敗しても「データ取得中」という代替テキストを表示して、ダッシュボード本体は正常に開けるように設計しておくのがプロの防壁です!
10. 今回のまとめ&次回予告
今回は、Google Apps Scriptから外部のWebサービスと通信してリアルタイムなデータを取得する UrlFetchApp.fetch() (GET) の使い方と、札幌オフィスのダッシュボードへの気象・交通情報ウィジェットの組み込み方を徹底解説しました!
本日の重要ポイントおさらい
UrlFetchApp.fetch("URL")で、外部のWeb APIから最新データをGET取得できる!- 戻り値は「小包(HTTPResponse)」なので、
getContentText()で中身のテキストを取り出すのが鉄則! - 第93回で学んだ
PropertiesServiceと組み合わせれば、秘密のAPIキーも安全に扱える! muteHttpExceptions: trueを設定しておけば、相手側のエラーでプログラムが強制終了するのを防げる!- 外部通信は相手のダウンに備えて必ず
try...catchで安全に囲んでおく!
Googleの閉じた世界(スプレッドシートやGmail)を飛び出して、世界中のインターネット上にあるオープンデータやWebサービスとGASが自由に会話できるようになったことで、自動化の可能性が宇宙のように大きく広がりましたね!
🚀 次回予告:APIデータの料理人になろう!
今回はサクッと JSON.parse() を使ってデータを取り出しましたが、外部APIとやり取りしていると、さらに奥深いデータ加工の壁にぶつかります。
「APIから返ってきた複雑に入り組んだ二重・三重のJSONから、欲しいデータだけを綺麗に引き抜くにはどうすればいいの?」
「逆に、スプレッドシートのデータを綺麗なJSONに変換して、外部のシステムへ正しく送り出すにはどうするの?」
そこで次回(第95回)のテーマは、
「JSON.parse() / JSON.stringify() × API送受信データのJSON相互解析・変換」 です!
Web API連携を極める上で絶対に避けては通れない「JSON形式データの完全攻略法」を、どこよりもわかりやすくお届けします。第96回の「Slack自動通知」へ向けて、データの変換力を完璧に仕上げていきましょう。次回もどうぞお楽しみに!
