Um script será vinculado a um arquivo do Planilhas, Documentos, Apresentações ou Formulários Google se for criado a partir desse documento, e não como um script independente. O arquivo ao qual um script vinculado está anexado é chamado de "contêiner". Scripts vinculados geralmente se comportam como scripts independentes, mas não aparecerem no Google Drive, eles não poderão ser removidos do arquivo ao qual estão vinculados, e recebem alguns privilégios especiais sobre o arquivo principal.
Os scripts também podem ser vinculados ao Google Sites, mas eles são quase sempre implantados como apps da Web. Roteiros vinculados a Planilhas, Documentos, Apresentações ou Formulários Google também podem se tornar apps da Web. isso é incomum.
Criar um script vinculado
Documentos, Planilhas ou Apresentações Google
Para criar um script vinculado no app Documentos, Planilhas ou Apresentações Google, abra um arquivo Documentos, uma planilha no Planilhas ou uma apresentação no Apresentações e clique em Extensões > Apps Script. Para reabrir o script em no futuro, faça a mesma coisa ou abra o script da Painel do Apps Script.
Formulários Google
Para criar um script vinculado no app Formulários Google, abra um arquivo e clique em Mais . > Roteiro editor. Para reabrir o script na no futuro, faça a mesma coisa ou abra o script da 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()permite que scripts vinculados consultem seu arquivo principal sem fazer referência ao ID do arquivo.getUipermite scripts vinculados acessam a interface do usuário para que seu arquivo pai adicione menus, caixas de diálogo e barras laterais personalizados.- Nas Planilhas Google,
getActiveSheet(),getActiveRange(), egetActiveCell()deixe o script determinar a página atual do usuário, o intervalo de células selecionado ou a célula individual selecionada.setActiveSheet(sheet)esetActiveRange(range)deixe o script alterar essas seleções. - Nos Documentos Google,
getCursor()egetSelection()deixe o script determinar a posição do cursor do usuário ou do texto selecionado.setCursor(position)esetSelection(range)deixe o script alterar esses locais.
Para mais informações, consulte a guia para ampliar Planilhas Google ou Guia para ampliar o acesso aos Documentos Google.
Menus, caixas de diálogo e barras laterais personalizados
Os scripts vinculados podem personalizar Planilhas, Documentos e Formulários Google adicionando menus personalizados e caixas de diálogo ou barras laterais. Lembre-se: No entanto, um script só pode interagir com a interface do usuário para o 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
Complementos que podem ser executados no Gmail, Planilhas Google, Documentos Google, Apresentações e Formulários. Se você desenvolveu uma limitação independente e quiser compartilhá-lo com o mundo, o Apps Script permite que você publicar seu script como para que outros usuários possam instalá-lo da 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 para editar. Como todos os tipos de script, eles podem
use também acionadores instaláveis.
Funções personalizadas
Uma função personalizada é uma função em um
vinculado às Planilhas Google que você chama diretamente de uma célula usando o
a sintaxe =myFunctionName(). Assim, as funções personalizadas são semelhantes às centenas de
funções integradas no app Planilhas
como AVERAGE ou
SUM, exceto que você define
o comportamento da função personalizada.
Acesso a scripts vinculados
Somente usuários com permissão para editar um contêiner podem executar o script vinculado. Os colaboradores com acesso apenas de leitura não podem abrir o script. editor, embora se façam uma cópia do arquivo de contêiner, eles se tornam o proprietário da cópia e pode ver e executar uma cópia do script.
Para saber como compartilhar o arquivo de contêiner de um script, consulte Compartilhar arquivos de Google Drive.