Google Sheets中assignScript()函数可访问脚本的限制及解决问询

核心限制说明 #

• assignScript() 指定的函数必须存在于目标电子表格自身绑定的脚本项目中。副本表格和原表格是完全独立的脚本执行环境，原表格的绑定脚本、未添加依赖的外部脚本库函数，副本表格都无法直接调用。
• 点击图片时，执行环境是副本表格的绑定脚本，只会在自身脚本项目内查找指定函数，找不到就会触发「函数不存在」的报错。

可行解决方案 #

方案1：自动给副本表格插入绑定脚本 #

通过Apps Script API，在创建副本后自动将目标函数写入副本的绑定脚本项目中。示例代码如下：

function mainCode(){
    const copyURL = copySheet(templateURL, destinationFolderID, copyName);
    const copySS = SpreadsheetApp.openByUrl(copyURL);
    const spreadsheetId = copySS.getId();
    
    // 获取副本的绑定脚本ID
    const scriptId = getScriptId(spreadsheetId);
    // 向副本脚本写入目标函数代码
    pushFunctionToScript(scriptId, `function scriptToBeAssigned(){
        // 这里填入你的函数逻辑
    }`);
    
    const images = copySS.getSheetByName(sheetName).getImages();
    images[0].assignScript("scriptToBeAssigned");
}

// 辅助函数：通过表格ID获取绑定脚本ID
function getScriptId(spreadsheetId) {
    const response = UrlFetchApp.fetch(`https://script.googleapis.com/v1/spreadsheets/${spreadsheetId}/content`, {
        headers: {Authorization: `Bearer ${ScriptApp.getOAuthToken()}`}
    });
    return JSON.parse(response.getContentText()).scriptId;
}

// 辅助函数：更新脚本项目代码
function pushFunctionToScript(scriptId, functionCode) {
    const payload = {
        files: [{
            name: "Code",
            type: "SERVER_JS",
            source: functionCode
        }]
    };
    UrlFetchApp.fetch(`https://script.googleapis.com/v1/projects/${scriptId}/content`, {
        method: "PUT",
        headers: {
            Authorization: `Bearer ${ScriptApp.getOAuthToken()}`,
            "Content-Type": "application/json"
        },
        payload: JSON.stringify(payload)
    });
}

注意：需要在脚本编辑器的「高级Google服务」中启用Apps Script API，同时在Google Cloud Console确认该API已开启。

方案2：给副本脚本添加脚本库依赖 #

如果目标函数已存入脚本库，可通过以下步骤让副本调用：

1. 在副本表格的脚本编辑器中，通过「资源 → 库」添加脚本库的ID，并设置访问权限为「可访问」。
2. 在副本的绑定脚本中添加占位函数，通过它调用库中的逻辑：

   function scriptToBeAssigned(){
       // 调用脚本库中的目标函数
       YourScriptLibraryName.scriptToBeAssigned();
   }
   

3. 再用assignScript()指定这个占位函数名即可。

方案3：模板表格预绑定函数 #

如果模板表格本身就绑定了scriptToBeAssigned()函数，复制表格时绑定脚本会同步复制。此时直接用assignScript()指定函数名，点击图片就能正常触发。

关键结论 #

• assignScript()无法直接跨表格调用绑定脚本，也不能调用未添加依赖的脚本库函数，必须确保目标函数存在于副本自身的绑定脚本项目中。
• 脚本库必须先在副本脚本中添加依赖，才能通过函数名调用。

内容的提问来源于stack exchange，提问作者AnonymousTurtle