GASのUrlFetchAppで
外部APIと連携する方法｜GET・POST・認証

function fetchExchangeRate() {
  // GETリクエスト（method を省略すると get になる）
  const url = 'https://api.example.com/v1/rates?base=JPY';
  const response = UrlFetchApp.fetch(url);

  // レスポンス本文（文字列）を取り出す
  const text = response.getContentText();

  // JSON文字列をオブジェクトに変換して使う
  const data = JSON.parse(text);

  Logger.log(data.rates.USD); // 例: 0.0064
  return data;
}

function fetchWithOptions() {
  const url = 'https://api.example.com/v1/users';

  const options = {
    method: 'get',
    // 例外を投げず、ステータスコードを自分で確認する
    muteHttpExceptions: true,
    // リダイレクトを自動で追わない場合は false
    followRedirects: true,
  };

  const response = UrlFetchApp.fetch(url, options);
  Logger.log(response.getResponseCode()); // 200 など
  Logger.log(response.getContentText());
}

function postJson() {
  const url = 'https://api.example.com/v1/tasks';

  const body = {
    title: '見積書を作成する',
    dueDate: '2026-08-01',
    done: false,
  };

  const options = {
    method: 'post',
    contentType: 'application/json',
    // オブジェクトは JSON.stringify で文字列にして送る
    payload: JSON.stringify(body),
    muteHttpExceptions: true,
  };

  const response = UrlFetchApp.fetch(url, options);
  const code = response.getResponseCode();

  if (code === 200 || code === 201) {
    const created = JSON.parse(response.getContentText());
    Logger.log('登録成功: ' + created.id);
  } else {
    Logger.log('登録失敗(' + code + '): ' + response.getContentText());
  }
}

function fetchWithAuth() {
  // APIキーはコードに直書きせず、PropertiesService から読む
  const token = PropertiesService
    .getScriptProperties()
    .getProperty('API_TOKEN');

  const url = 'https://api.example.com/v1/me';

  const options = {
    method: 'get',
    headers: {
      // Bearer トークン認証
      Authorization: 'Bearer ' + token,
      Accept: 'application/json',
    },
    muteHttpExceptions: true,
  };

  const response = UrlFetchApp.fetch(url, options);
  Logger.log(response.getResponseCode());
  return JSON.parse(response.getContentText());
}

function fetchSafely(url) {
  const options = { method: 'get', muteHttpExceptions: true };
  const response = UrlFetchApp.fetch(url, options);
  const code = response.getResponseCode();

  // 200番台だけを成功として扱う
  if (code >= 200 && code < 300) {
    return JSON.parse(response.getContentText());
  }

  // それ以外はエラーとして扱い、内容をログに残す
  if (code === 429) {
    Logger.log('レート制限。時間をおいて再実行してください');
  } else if (code >= 500) {
    Logger.log('サーバー側エラー(' + code + ')');
  } else {
    Logger.log('リクエストエラー(' + code + '): '
      + response.getContentText());
  }
  return null;
}

function fetchManyUrls() {
  const urls = [
    'https://api.example.com/v1/items/1',
    'https://api.example.com/v1/items/2',
    'https://api.example.com/v1/items/3',
  ];

  // リクエストの配列を作る
  const requests = urls.map(function (url) {
    return { url: url, method: 'get', muteHttpExceptions: true };
  });

  // まとめて並行実行（1件ずつ fetch するより速い）
  const responses = UrlFetchApp.fetchAll(requests);

  const results = responses.map(function (res) {
    if (res.getResponseCode() === 200) {
      return JSON.parse(res.getContentText());
    }
    return null;
  });

  Logger.log(results.length + '件取得しました');
  return results;
}

function saveApiResultToSheet() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet()
    .getSheetByName('データ');

  const response = UrlFetchApp.fetch(
    'https://api.example.com/v1/users',
    { method: 'get', muteHttpExceptions: true }
  );
  if (response.getResponseCode() !== 200) return;

  const users = JSON.parse(response.getContentText());

  // API のレスポンスを二次元配列にして一括書き込み
  const rows = users.map(function (u) {
    return [u.id, u.name, u.email];
  });

  if (rows.length > 0) {
    sheet.getRange(2, 1, rows.length, 3).setValues(rows);
  }
}