[GAS] Template 解析異常

請 AI 寫小範例驗證功能時，發生下述錯誤訊息

SyntaxError: Unexpected token ';' (第 18 行，檔案名稱：程式碼)

該範例就單純在 code.gs 內的參數傳遞至 Index.html 而已，因為錯誤訊息一直指向 code.gs 內，所以第一時間也沒有意識到錯誤是在 Index.html 內，都修錯方向

部屬執行後都出現下面錯誤訊息

錯誤竟然在 Index.html 內的註解，傻眼

正確應該是下圖才是，這樣才會正確解析 < 和 > 符號，但這是註解說，本來就沒有要顯示，真的打在有趣的點

• 延伸閱讀
• [GAS] HTMLService - createTemplateFromFile

[GAS] CacheService

Google Apps Script 本身有快取服務 CacheService 可以直接使用，分別為

• getDocumentCache()
• getScriptCache()
• getUserCache()

該筆記以 getScriptCache() 為目標筆記，文件說明

Gets the cache instance scoped to the script. Script caches are common to all users of the script. Use these to store information that is not specific to the current user.

CacheServide 最多儲存 1,000 筆，超過 1,000 筆的話會保留 expirationInSeconds 最長的 900 筆資料

CRUD Sample Code

直接請 AI 產出紀錄

/**
 * 示範 Google Apps Script 的 CacheService 混合寫入操作
 * 包含 putAll (批量新增)、put (單筆新增)、getAll (批量讀取)、刪除與驗證
 * * @returns {void}
 */
function demoCacheServiceMixedCRUD() {
  // 1. 初始化 ScriptCache
  const cache = CacheService.getScriptCache();
  
  // 2. 使用 putAll() 批量新增三筆資料
  // 將快取資料整理成一個 Object (KeyValue)
  const batchData = {
    'user_01': 'Alice',
    'user_02': 'Bob',
    'user_03': 'Charlie'
  };
  // 寫入批次資料，設定存活時間為 600 秒 (預設值)
  cache.putAll(batchData, 600);
  console.log('✅ 已使用 putAll() 成功新增三筆資料至 Cache。');

  // 3. 使用 put() 追加新增單一筆資料
  const singleKey = 'user_04';
  cache.put(singleKey, 'David', 600);
  console.log(`✅ 已使用 put() 成功追加一筆資料至 Cache：${singleKey}`);

  // 4. 取得全部資料 (Read)
  // 將批次寫入的 keys 與單筆寫入的 key 合併成一個陣列來查詢
  const allKeysToFetch = ['user_01', 'user_02', 'user_03', 'user_04'];
  const allData = cache.getAll(allKeysToFetch);
  console.log('🔍 取得目前的資料狀態：', allData);

  // 5. 移除一筆資料 (Delete)
  const targetToRemove = 'user_02'; // 準備移除 Bob
  cache.remove(targetToRemove);
  console.log(`🗑️ 已執行移除動作，目標：${targetToRemove}`);

  // 6. 取得上一筆移除資料，驗證該筆資料已不存在
  const removedData = cache.get(targetToRemove);
  
  if (removedData === null) {
    console.log(`⚠️ 驗證成功：${targetToRemove} 已經被移除 (查詢結果為 null)。`);
  } else {
    console.log(`❌ 錯誤：${targetToRemove} 依然存在，值為：`, removedData);
  }
}

put(key, value, expirationInSeconds)

• key：最多 250 字元
• value：每一筆資料最大是 100KB
• expirationInSeconds：預設值為 600 秒 (10 分鐘) ，最少為 1 秒、最長為 21,600 秒 (6 小時)，指定的到期時間僅供參考，如果快取大量資料，系統可能會提前移除快取資料 (有 1,000 筆快取限制)

• 參考資料
• Class Cache
• Google App Script - Cache Service 做快取

[SQL] 稀疏欄位 (Sparse Column)

稀疏欄位 (Sparse Column) 是 MS SQL 2008 功能，官方文件說明

Sparse columns are ordinary columns that have an optimized storage for null values. Sparse columns reduce the space requirements for null values at the cost of more overhead to retrieve non-NULL values. Consider using sparse columns when the space saved is at least 20 percent to 40 percent.

Sparse 關鍵字

USE AdventureWorks2025;  
GO  
  
CREATE TABLE DocumentStore  
    (DocID int PRIMARY KEY,  
     Title varchar(200) NOT NULL,  
     ProductionSpecification varchar(20) SPARSE NULL,  -- SPARSE Column 
     ProductionLocation smallint SPARSE NULL,          -- SPARSE Column
     MarketingSurveyGroup varchar(20) SPARSE NULL ) ;  -- SPARSE Column
GO  

Sparse Column 查詢

use AdventureWorks2025
go 

SELECT 
	[name] AS ColumnName ,
	is_nullable ,
	is_sparse ,
	is_column_set
FROM sys.columns
WHERE object_name(object_id) =  'DocumentStore'

限制

• Sparse columns are a property of the storage layer, rather than the logical table. Therefore a SELECT ... INTO statement does not copy over the sparse column property into a new table.
• A sparse column must be nullable and cannot have the ROWGUIDCOL or IDENTITY properties. A sparse column cannot be of the following data types: text, ntext, image, timestamp, user-defined data type, geometry, or geography; or have the FILESTREAM attribute.
• A sparse column cannot have a default value.
• Sparse columns are incompatible with data compression. Therefore sparse columns cannot be added to compressed tables, nor can any tables containing sparse columns be compressed.
• Changing a column from sparse to non-sparse, or non-sparse to sparse, requires changing the storage format of the column. The SQL Server Database Engine uses the following procedure to accomplish this change: 
•  Adds a new column to the table in the new storage size and format. 
•  For each row in the table, updates and copies the value stored in the old column to the new column. 
•  Removes the old column from the table schema. 
•  Rebuilds the table (if there is no clustered index) or rebuilds the clustered index to reclaim space used by the old column.

以上只列出較感興趣限制，完整限制說明可以查看 Restrictions for using sparse columns

重構某單位 AP 時發現 Table 整併後，配合商業邏輯而新增欄位內有 90% 資料會是 null，原本是想要多拆一個 Table 來存放節省空間，但該情境似乎蠻符合 Sparse Column 就來使用看看囉

• 延伸閱讀
• [SQL] 篩選索引和參數化查詢
• 參考資料
• Use sparse columns
• sys.columns
• ALTER TABLE  - H. Add a sparse column

[GAS] 網頁應用程式 - Google 帳號

以往把 GAS 發佈為網頁應用程式時，設定值都是

• 執行身份：我 (gmail 信箱)
• 誰可以存取：所有人

該筆記使用

• 執行身份：存取網頁應用程式的使用者
• 誰可以存取：所有已登入 Google 帳戶的使用者

來記錄，並設定存取名單，不在存取名單內即使有登錄 Google 帳號也無法存取網頁

使用者 Email

透過 getActiveUser() 來存取 Google 帳號 Email

Gets information about the current user. If security policies do not allow access to the user's identity, User.getEmail() returns a blank string. The circumstances in which the email address is available vary: for example, the user's email address is not available in any context that allows a script to run without that user's authorization, like a simple onOpen(e) or onEdit(e) trigger, a custom function in Google Sheets, or a web app deployed to "execute as me" (that is, authorized by the developer instead of the user). However, these restrictions generally do not apply if the developer runs the script themselves or belongs to the same Google Workspace domain as the user.

網頁存取名單

在 GAS PropertyService 內設定存取存取名單，存取名單已逗號 (,) 分隔，例如：123@gmail.com,456@gmail.com，當然也可以放在 Google Sheet 或第三方資料庫來管理存取名單

gs Code

/**
 * 系統配置參數
 * @constant {Object}
 */
const CONFIG = {
  PROPERTY_KEY: 'WHITELIST' // 儲存在指令碼屬性中的鍵名
};

/**
 * 從指令碼屬性 (PropertiesService) 中獲取白名單。
 * @returns {string[]} 允許存取的 Google 帳號信箱陣列。
 */
const getAllowedEmails = () => {
  const whitelistStr = PropertiesService.getScriptProperties().getProperty(CONFIG.PROPERTY_KEY);
  
  if (!whitelistStr) {
    console.warn('目前沒有設定任何白名單。');
    return [];
  }

  // 將字串轉為陣列，過濾空白並轉為小寫
  return whitelistStr.split(',')
    .map(email => email.trim().toLowerCase())
    .filter(email => email !== '');
};

/**
 * 處理 Web App 的 HTTP GET 請求。
 * @param {Object} e - 事件物件。
 * @returns {GoogleAppsScript.HTML.HtmlOutput} 根據使用者權限回傳對應的 HTML 頁面。
 */
const doGet = (e) => {
  const currentUserEmail = Session.getActiveUser().getEmail().toLowerCase();
  const allowedEmails = getAllowedEmails();

  if (allowedEmails.includes(currentUserEmail)) {
    // 驗證通過
    const template = HtmlService.createTemplateFromFile('Index');
    template.userEmail = currentUserEmail; 
    
    return template.evaluate().setTitle('系統主控台');
  } else {
    // 驗證失敗
    const template = HtmlService.createTemplateFromFile('Error');
    template.userEmail = currentUserEmail;
    
    return template.evaluate().setTitle('存取被拒絕');
  }
};

Index.html 和 Error.html 就不特別列出來囉

實際執行

進入網頁時假如沒有登錄 Google 帳號，會出現 Google 登錄畫面

登錄 Google 帳號後則是檢查該帳號是否在存取白名單內

限制

實作發現，原來 getActiveUser() 在 [執行身份：我 (gmail 信箱)] 時，使用者執行網頁時會回傳空值，該情況只有執行身份信箱使用者可以透過 getActiveUser() 取得 gmail 資訊

[執行身份：存取網頁應用程式的使用者] 時，使用者執行網頁時雖然 getActiveUser() 可以取得 gmail 資訊進一步根據存取名單判斷是否有權限，但該身分初次存取網頁需授予權限，授予權限範圍則是依網頁使用相關服務不一，至少會要求存取使用者帳戶資訊，其實部屬畫面上就有簡易文字說明

原以為 [執行身份：我 (gmail 信箱)] 會類似一個服務帳號，該帳號擁有權限存取 Google 相關服務，而 getActiveUser() 則是可以抓到使用者 gmail 資訊，兩者搭配來實作存取名單功能，但在 GAS 內部架構下看起來沒有這麼理想

• 延伸閱讀
• [GAS] 部屬網頁程式
• [GAS] Properties Service
• 參考資料
• 建立共用函式

[GAS] Google Doc 轉為 PDF

GAS 內可以透過 getAs() 把 Google Doc 轉換為 PDF

限制

gs code

/**
 * 將指定的 Google Doc 文件轉換為 PDF，並儲存到指定的 Google Drive 資料夾中
 *
 * @param {string} documentId - 欲轉換的 Google Doc 檔案 ID
 * @param {string} folderId - 儲存 PDF 的目標資料夾 ID
 * @returns {string} 新建立的 PDF 檔案 URL
 * @throws {Error} 當缺少必要參數、找不到檔案、權限不足或轉換失敗時拋出錯誤
 */
function convertDocToPdf(documentId, folderId) {

  if (!documentId || !folderId) {
    throw new Error("執行失敗：必須同時提供 documentId (文件 ID) 與 folderId (目標資料夾 ID)。");
  }

  try {
    // 1. 透過 ID 取得指定的 Google 文件
    const docFile = DriveApp.getFileById(documentId);

    // 2. 將檔案轉換為 PDF 格式的 Blob (二進位大型物件)
    const pdfBlob = docFile.getAs(MimeType.PDF);

    // 3. 設定產出的 PDF 檔名 (預設為原檔名加上 .pdf)
    const newFileName = `${docFile.getName()}.pdf`;
    pdfBlob.setName(newFileName);

    // 4. 取得目標資料夾實體，並在該資料夾內直接建立 PDF 檔案
    const folder = DriveApp.getFolderById(folderId);
    const newPdfFile = folder.createFile(pdfBlob);
    return newPdfFile.getUrl();

  } catch (error) {
    throw new Error(`PDF 轉換程序發生錯誤: ${error.message}`);
  }
}

執行

function testConvertDocToPdf() {
  const targetDocumentId = "1x17o_MEpEU-S2jKzFhdVqfQ3bswGVPKf2ottem8TSRE"; 
  const targetFolderId = "1Odq3pbNO63RxXmrxWNM9vSGWuGWyBmbZ";

  try {
    const pdfUrl = convertDocToPdf(targetDocumentId, targetFolderId);
    console.log(`轉換完成！PDF 檔案已儲存至指定資料夾，連結請見: ${pdfUrl}`);
  } catch (error) {
    console.error(error);
  }
}

• 延伸閱讀
• [GAS] Slide 合併資料
• 參考資料
• D26 自動產生文件 & PDF