GASで外部APIにファイルを
アップロードする方法｜multipart/form-data

// これは動きません。FormData はブラウザのAPIで、GASには存在しない
function uploadNg() {
  const form = new FormData(); // ReferenceError: FormData is not defined
  form.append("file", someFile);
  UrlFetchApp.fetch("https://api.example.com/upload", {
    method: "post",
    payload: form,
  });
}

function uploadFile() {
  // 送りたいファイルをBlob（ファイルの中身を表すGASのオブジェクト）として用意する
  const blob = DriveApp.getFileById("ここにファイルID").getBlob();

  const options = {
    method: "post",
    // payload の値に Blob が含まれていると、UrlFetchApp が
    // 自動で multipart/form-data として組み立てて送信する
    payload: {
      file: blob,          // ファイル本体のパート
      title: "月次レポート", // 文字列のパートも同時に送れる
      category: "report",
    },
    headers: {
      Authorization: "Bearer " + getApiToken(),
    },
    muteHttpExceptions: true, // エラーでも例外にせずレスポンスを受け取る
  };

  const response = UrlFetchApp.fetch("https://api.example.com/v1/files", options);
  const code = response.getResponseCode();

  if (code >= 200 && code < 300) {
    console.log("アップロード成功: " + response.getContentText());
  } else {
    console.error("失敗 (" + code + "): " + response.getContentText());
  }
}

function getApiToken() {
  // APIキーはコードに直接書かず、スクリプトプロパティに保存しておく
  return PropertiesService.getScriptProperties().getProperty("API_TOKEN");
}

// NG: contentType を自分で書くと boundary が食い違い、サーバーが解析できない
const ngOptions = {
  method: "post",
  contentType: "multipart/form-data", // ← boundary が付いていない
  payload: { file: blob },
};

// OK: contentType は指定しない。GAS が boundary 付きで自動生成してくれる
const okOptions = {
  method: "post",
  payload: { file: blob },
};

// 1. ドライブ上のファイルをそのまま送る（名前とMIMEタイプは元のまま）
const driveBlob = DriveApp.getFileById(fileId).getBlob();

// 2. スプレッドシートをPDFにして送る
const ss = SpreadsheetApp.getActive();
const pdfBlob = ss.getAs("application/pdf").setName("売上報告_2026-07.pdf");

// 3. 文字列からCSVを作って送る
const csv = "商品,数量\n" + "りんご,10\n" + "みかん,5\n";
const csvBlob = Utilities.newBlob(csv, "text/csv", "sales.csv");
// 日本語のCSVをExcelで開く前提なら、UTF-8のBOMを先頭に付けると文字化けを防げる
const bomBlob = Utilities.newBlob(
  Utilities.newBlob("\uFEFF").getBytes().concat(Utilities.newBlob(csv).getBytes()),
  "text/csv",
  "sales.csv"
);

// 4. 別のAPIから取得したファイルをそのまま中継する
const fetched = UrlFetchApp.fetch("https://example.com/logo.png").getBlob();
fetched.setName("logo.png");

// ファイル名とMIMEタイプは Blob 自身に持たせる。ここが multipart の各パートに反映される
driveBlob.setName("契約書.pdf");
driveBlob.setContentType("application/pdf");

// Google Drive API に multipart アップロードする例
// メタデータ（JSON）とファイル本体を multipart/related で1回のリクエストに詰める
function uploadToDrive(blob, folderId) {
  const boundary = "-----gas-boundary-" + Utilities.getUuid();

  const metadata = {
    name: blob.getName(),
    mimeType: blob.getContentType(),
    parents: [folderId],
  };

  // 前半（テキスト）→ ファイル本体（バイナリ）→ 終端 の順にバイト配列を連結する
  const head =
    "--" + boundary + "\r\n" +
    "Content-Type: application/json; charset=UTF-8\r\n\r\n" +
    JSON.stringify(metadata) + "\r\n" +
    "--" + boundary + "\r\n" +
    "Content-Type: " + blob.getContentType() + "\r\n\r\n";
  const tail = "\r\n--" + boundary + "--";

  const payload = Utilities.newBlob(head)
    .getBytes()
    .concat(blob.getBytes())
    .concat(Utilities.newBlob(tail).getBytes());

  const response = UrlFetchApp.fetch(
    "https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart",
    {
      method: "post",
      // 手組みするときは boundary 込みで contentType を指定する
      contentType: "multipart/related; boundary=" + boundary,
      payload: payload,
      headers: {
        // 同じGoogleアカウントの権限をそのまま使う
        Authorization: "Bearer " + ScriptApp.getOAuthToken(),
      },
      muteHttpExceptions: true,
    }
  );

  if (response.getResponseCode() !== 200) {
    throw new Error("Driveアップロード失敗: " + response.getContentText());
  }
  return JSON.parse(response.getContentText()).id;
}

// appsscript.json に必要なスコープを明示しておく
{
  "timeZone": "Asia/Tokyo",
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.external_request",
    "https://www.googleapis.com/auth/drive.file"
  ]
}

// シートのファイルID一覧を順にアップロードし、結果を書き戻す
function uploadFromSheet() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("アップロード対象");
  const values = sheet.getDataRange().getValues();
  const started = new Date().getTime();

  for (let i = 1; i < values.length; i++) {
    const fileId = values[i][0];
    const status = values[i][1];
    if (!fileId || status === "完了") continue; // 処理済みは飛ばす

    // 実行時間の上限（6分）に近づいたら、途中で切り上げる
    if (new Date().getTime() - started > 4.5 * 60 * 1000) {
      console.log(i + "行目で中断しました。次回の実行で続きから再開します。");
      break;
    }

    try {
      const blob = DriveApp.getFileById(fileId).getBlob();
      const remoteId = uploadToApi(blob);
      sheet.getRange(i + 1, 2).setValue("完了");
      sheet.getRange(i + 1, 3).setValue(remoteId);
    } catch (e) {
      sheet.getRange(i + 1, 2).setValue("エラー");
      sheet.getRange(i + 1, 3).setValue(String(e).slice(0, 200));
    }
    SpreadsheetApp.flush(); // 進捗をその場でシートに反映する
  }
}

function debugUpload(blob) {
  const response = UrlFetchApp.fetch(url, {
    method: "post",
    payload: { file: blob },
    muteHttpExceptions: true,
  });

  console.log("status: " + response.getResponseCode());
  console.log("body: " + response.getContentText().slice(0, 500));

  // 送信サイズを確認する（POSTペイロードの上限は 50MB）
  console.log("size: " + Math.round(blob.getBytes().length / 1024) + " KB");
}