Um script é vinculado a um arquivo dos apps Planilhas, Documentos, Apresentações ou Formulários Google se foi criado a partir desse documento, em vez de ser um script independente. O arquivo a que um script vinculado é anexado é chamado de "contêiner". Os scripts vinculados geralmente se comportam como scripts independentes, exceto pelo fato de que eles não aparecem no Google Drive, não podem ser separados do arquivo a que estão vinculados e ganham alguns privilégios especiais em relação ao arquivo principal.
Os scripts também podem ser vinculados ao Google Sites, mas quase sempre são implantados como apps da Web. Os scripts vinculados a Planilhas, Documentos, Apresentações ou Formulários Google também podem se tornar apps da Web, embora isso seja incomum.
Criar um script vinculado
Documentos, Planilhas ou Apresentações Google
Para criar um script vinculado nos apps Documentos, Planilhas ou Apresentação Google, abra um documento no app Documentos, uma planilha no app Planilhas ou uma apresentação no app Apresentação e clique em Extensões > Apps Script. Para reabrir o script no futuro, faça o mesmo ou abra o script no painel do Apps Script.
Formulários Google
Para criar um script vinculado no Google Forms, abra um formulário e clique em Mais > Editor de script. Para reabrir o script no futuro, faça o mesmo ou abra-o no Painel do Apps Script.
Métodos especiais
Os scripts vinculados podem chamar alguns métodos que os scripts independentes não podem:
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation()egetActiveForm()permitem que scripts vinculados se refiram ao arquivo pai sem se referir ao ID do arquivo.getUipermite que scripts vinculados acessem a interface do usuário do arquivo pai para adicionar menus, caixas de diálogo e barras laterais personalizados.- Nas Planilhas Google,
getActiveSheet(),getActiveRange()egetActiveCell()permitem que o script determine a planilha atual do usuário, o intervalo de células selecionado ou a célula individual selecionada.setActiveSheet(sheet)esetActiveRange(range)permitem que o script mude essas seleções. - Nos Documentos Google,
getActiveTab(),getCursor()egetSelection()permitem que o script determine a guia atual do usuário, a posição do cursor ou o texto selecionado.setActiveTab(tabId),setCursor(position)esetSelection(range)permitem que o script mude essas seleções.
Para mais informações, consulte o guia de extensão das Planilhas Google ou o guia de extensão dos Documentos Google.
Menus, caixas de diálogo e barras laterais personalizadas
Os scripts vinculados podem personalizar as Planilhas, os Documentos e os Formulários Google adicionando menus personalizados e caixas de diálogo ou barras laterais. No entanto, um script só pode interagir com a interface do usuário para a instância atual de um arquivo aberto. Ou seja, um script vinculado a um documento não pode afetar a interface do usuário de outro documento.
Complementos
Os complementos são executados no Gmail, no Planilhas, nos Documentos, nas Apresentações e no Formulários Google. Se você desenvolveu um script vinculado ou independente e quer compartilhá-lo com o mundo, o Apps Script permite publicar seu script como um complemento para que outros usuários possam instalá-lo na loja de complementos.
Gatilhos
Os scripts vinculados podem usar acionadores simples,
como a função especial onOpen(), que é executada automaticamente sempre que um arquivo
é aberto por um usuário com acesso de edição. Como todos os tipos de script, eles também podem
usar gatilhos instaláveis.
Funções personalizadas
Uma função personalizada é uma função em um
script vinculado às Planilhas Google que você chama diretamente de uma célula usando a
sintaxe =myFunctionName(). As funções personalizadas são semelhantes às centenas de
funções integradas nas Planilhas,
como AVERAGE ou
SUM, exceto pelo fato de você definir
o comportamento da função personalizada.
Acesso a scripts vinculados
Somente os usuários que têm permissão para editar um contêiner podem executar o script vinculado. Os colaboradores que têm apenas acesso de leitura não podem abrir o editor de script, mas, se fizerem uma cópia do arquivo do contêiner, eles se tornam proprietários da cópia e podem visualizar e executar uma cópia do script.
Para saber como compartilhar o arquivo de contêiner de um script, consulte Compartilhar arquivos do Google Drive.