はじめに

「Instagramの投稿URLをGoogleフォームに貼ったら、自動的にGoogleドライブへ保存される仕組みが欲しい」そう思い立ってバイブコーディングで作り始めたました！
Gemini 3 無料枠

この記事では、私が開発中に躓いた「GASのトリガー問題」や「APIレスポンスの構造解析」など、試行錯誤の記録をまとめました。

開発環境

Google Apps Script (GAS)
Google フォーム
RapidAPI (instagram120)
Google ドライブ

躓きポイント1：トリガー設定に「フォームから」が出てこない

最初の壁は、フォーム送信時にスクリプトを動かすための設定でした。 Geminiは「イベントのソースを選択：フォームから」を選ぶと言ってるのに、私の画面には「スプレッドシートから」しか出てこない……。

原因と解決

これは、GASの作り方に原因がありました。

NG: Googleドライブの「新規」から直接GASファイルを作った（スタンドアロン・スクリプト）。
OK: Googleフォームの編集画面にある「︙（三点リーダー）」→「スクリプトエディタ」 から作成する（コンテナバインド・スクリプト）

GASは「どこから開いたか」で持っている権限や設定項目が変わるんですね。この違いを知っているだけで、躓きを防げます。

躓きポイント2：`Cannot read properties of undefined (reading 'getResponse')`

いざ実行！と思ったら、実行ログにこのエラー。これは、プログラムが「2番目の回答（保存先など）」を取得しようとしているのに、実際のフォームには「URL」の質問1つしかなかったために発生していました。
実は最初は保存先をフォームで選択できるように２つ目にその質問を追加する予定でコーディングしてました。

// エラーになった箇所のイメージ  
const itemResponses = e.response.getItemResponses();  
const fullUrl = itemResponses[0].getResponse();  
const destination = itemResponses[1].getResponse(); // 2つ目の質問がないため、ここで undefined エラー！

将来的に項目を増やす予定でも、現時点でのフォームの質問数と、コード内のインデックス（[0], [1]）は厳密に合わせる必要があることを学びました。

躓きポイント3：APIのレスポンスが「配列」だった

今回使用したAPIはinstagram120 というRapidAPIにあるものを使用しました。
https://rapidapi.com/3205/api/instagram120

投稿データを取得すると、画像URLが1つだけ返ってくると思いきや、実際には 「複数枚投稿」に対応したリスト形式でデータが返ってきていました。

ログを確認するとこんな構造でした：
[ { "pictureUrl": "...", ... }, { "pictureUrl": "...", ... } ]

この構造を理解せずに単一のオブジェクトとして扱おうとしても、画像は見つかりません。forEach を使って、リストの中身を一つずつ取り出す処理に書き換えることで、複数枚投稿の全保存に対応できました。

実装のこだわりポイント

1. 日本時間（JST）への確実な変換

APIから返ってくる投稿日時はUTC（世界標準時）ですが、管理しやすいように日本時間に変換しました。 Utilities.formatDate(date, "JST", "yyyyMMdd_HHmm") を使うことで、夜中に投稿されたものも正しく「日本時間」でファイル名に反映されます。

2. 「上書き保存」ロジックの導入

同じURLを2回送ったとき、同じファイルが重複するのを防ぐため、「保存先に同名のファイルがあれば、古い方をゴミ箱へ移動してから新しく保存する」 という処理を追加しました。これにより、1回目が失敗した時のリトライもスムーズになり、フォルダが散らかるのも防げます。

3. 拡張子 `.jpg` の明示

Googleドライブ上では拡張子がなくてもプレビューできますが、PCにダウンロードして整理したり、今後別のサービスと連携する際の利便性を考えて、あえて .jpg を付加する仕様にしました。

完成したコード (メインロジック)

/**  
 * フォーム送信時に実行されるメイン関数  
 */  
function onFormSubmit(e) {  
  const props = PropertiesService.getScriptProperties().getProperties();  
  const itemResponses = e.response.getItemResponses();  
  const fullUrl = itemResponses[0].getResponse().trim();  
    
  // 1. ショートコードの抽出  
  const shortcode = fullUrl.match(//(?:p|reels|reel)/([^/?#&]+)/)[1];

  // 2. APIリクエスト  
  const apiUrl = '[https://instagram120.p.rapidapi.com/api/instagram/mediaByShortcode](https://instagram120.p.rapidapi.com/api/instagram/mediaByShortcode)';  
  const options = {  
    "method": "post",  
    "contentType": "application/json",  
    "headers": {  
      "x-rapidapi-key": props.RAPID_API_KEY,  
      "x-rapidapi-host": "instagram120.p.rapidapi.com"  
    },  
    "payload": JSON.stringify({ "shortcode": shortcode })  
  };

  const response = UrlFetchApp.fetch(apiUrl, options);  
  const results = JSON.parse(response.getContentText()); // ここが配列 []

  const folder = DriveApp.getFolderById(props.DRIVE_FOLDER_ID);

  // 3. 取得した全画像をループ処理で保存  
  results.forEach((item, index) => {  
    const imgUrl = item.pictureUrl;  
    if (!imgUrl) return;

    const username = item.meta?.username || "unknown";  
    const date = new Date(item.meta?.takenAt * 1000);  
    const dateString = Utilities.formatDate(date, "JST", "yyyyMMdd_HHmm");  
      
    const fileName = `insta_${username}_${dateString}_${index + 1}.jpg`;  
      
    // 上書きロジック（同名ファイルをゴミ箱へ）  
    const existingFiles = folder.getFilesByName(fileName);  
    while (existingFiles.hasNext()) {  
      existingFiles.next().setTrashed(true);  
    }

    const blob = UrlFetchApp.fetch(imgUrl).getBlob();  
    folder.createFile(blob).setName(fileName);  
    console.log(`保存完了: ${fileName}`);  
  });  
}

振り返りと今後の展望

今回は「画像」に絞りましたが、APIレスポンスを詳しく解析すると動画URL（videoUrl）も含まれているようなので、それも含め今後は...

動画（MP4）保存対応
エラー通知機能
APIの無料枠を使い切った際や、通信エラー時にLINEやメールで自分に通知する。
Googleフォトへの自動同期 or 直保存（Google Driveは画像閲覧しずらいので...）
インスタアカウントごとにフォルダを自動生成してそこに保存

辺りを検討しましたが気が向いたらまたやりましょう！
一旦は完成ということで！