I have come up with a solution that works for me. It allows keeping any number of scripts attached to a sort of master document (let's call it MyScripts). No libraries, no publishing required.
Create a document and name it MyScripts (or whatever). The document's body can be empty, or you could write some instructions there. Then, paste the following code into MyScript's script editor:
// adds a menu to the master document's UI
function onOpen() {
DocumentApp.getUi()
.createAddonMenu()
.addItem('Do something', 'doSomething')
.addItem('Something else', 'somethingElse')
.addToUi()
}
// returns the target document based on its URL
// may be tweaked in order to use the documentId instead
function findDoc(prompt) {
var ui = DocumentApp.getUi();
var pro = ui.prompt(prompt, 'Document URL:', ui.ButtonSet.OK);
var url = pro.getResponseText();
return DocumentApp.openByUrl(url);
}
function doSomething() {
var doc = findDoc('Do something');
if (doc) {
// do something with the target document
var len = doc.getBody().getText().length;
DocumentApp.getUi().alert('The document is ' + len + ' characters long')
}
}
function somethingElse() {
var doc = findDoc('Something else');
if (doc) {
// do something else
}
}
The onOpen()
function should be self explanatory.
findDoc()
is the real hack. It prompts the user for the URL of the target document, the document we want to act on. If the URL is valid, then findDoc()
returns the corresponding document object.
The last two functions are just stubs and should be replaced with your own code, but notice how findDoc()
gets called at the beginning of each.
When you want to run a script against a document, copy its URL, then open MyScripts, choose the corresponding Add-Ons menu item, paste the URL and click OK.
Please notice that you will get a scary warning message the first time you attempt to run a script this way. Just be sure that your doSomething()
, your somethingElse()
, etc. only contain safe code before ignoring the warnings and executing the scripts.