Kết nối nhanh bằng Apps Script

/**
 * Viet Dataverse — Google Sheets connector
 * Dùng: =VDV_GOLD("SJC","1m")   (token nhập 1 lần qua menu, không gõ lại)
 */
const VDV_BASE = 'https://api.vietdataverse.online/api/v1';

function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('Viet Dataverse')
    .addItem('Nhập / cập nhật API key', 'VDV_promptKey_')
    .addItem('Xoá API key', 'VDV_clearKey_')
    .addToUi();
}

function VDV_promptKey_() {
  const ui = SpreadsheetApp.getUi();
  const res = ui.prompt('Viet Dataverse', 'Dán API key (lấy ở trang Developer):', ui.ButtonSet.OK_CANCEL);
  if (res.getSelectedButton() !== ui.Button.OK) return;
  const key = res.getResponseText().trim();
  if (!key) { ui.alert('Key rỗng.'); return; }
  PropertiesService.getScriptProperties().setProperty('VDV_API_KEY', key);
  ui.alert('Đã lưu API key. Giờ gõ:  =VDV_GOLD("SJC","1m")');
}

function VDV_clearKey_() {
  PropertiesService.getScriptProperties().deleteProperty('VDV_API_KEY');
  SpreadsheetApp.getUi().alert('Đã xoá API key.');
}

function VDV_key_() {
  const k = PropertiesService.getScriptProperties().getProperty('VDV_API_KEY');
  if (!k) throw new Error('Chưa có API key — menu "Viet Dataverse" -> "Nhập API key".');
  return k;
}

function VDV_fetch_(path, params) {
  params = params || {};
  params.format = 'csv';
  params.api_key = VDV_key_();
  const qs = Object.keys(params)
    .map(function (k) { return k + '=' + encodeURIComponent(params[k]); })
    .join('&');
  const resp = UrlFetchApp.fetch(VDV_BASE + path + '?' + qs, { muteHttpExceptions: true });
  const code = resp.getResponseCode();
  if (code !== 200) {
    throw new Error('Viet Dataverse lỗi ' + code + ': ' + resp.getContentText().slice(0, 150));
  }
  // CSV -> mảng 2 chiều; đổi ô số sang kiểu number để vẽ chart được
  return Utilities.parseCsv(resp.getContentText()).map(function (row) {
    return row.map(function (cell) {
      return (cell !== '' && !isNaN(cell)) ? Number(cell) : cell;
    });
  });
}

/**
 * Giá vàng Việt Nam.
 * @param {string} type Loại vàng: "SJC", "DOJI HN", "PNJ", "BTMC". Mặc định "SJC".
 * @param {string} period "7d", "1m", "1y", "all". Mặc định "1m".
 * @return Bảng: ngày | giá mua | giá bán
 * @customfunction
 */
function VDV_GOLD(type, period) {
  return VDV_fetch_('/gold', { type: type || 'SJC', period: period || '1m' });
}