Class ScriptApp

Remove o acionador especificado para que ele não seja mais executado.

// Deletes all triggers in the current project.
const triggers = ScriptApp.getProjectTriggers();
for (let i = 0; i < triggers.length; i++) {
  ScriptApp.deleteTrigger(triggers[i]);
}

Parâmetros

Nome	Tipo	Descrição
trigger	Trigger	O acionador a ser excluído.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/script.scriptapp

Recebe um objeto usado para determinar se o usuário precisa autorizar esse script a usar um ou mais serviços e fornecer o URL de uma caixa de diálogo de autorização. Se o script for publicado como um complemento que usa gatilhos instaláveis, essas informações poderão ser usadas para controlar o acesso a seções de código para as quais o usuário não tem a autorização necessária. Como alternativa, o complemento pode pedir que o usuário abra o URL da caixa de diálogo de autorização para resolver o problema.

var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
status = authInfo.getAuthorizationStatus();
url = authInfo.getAuthorizationUrl();

Parâmetros

Nome	Tipo	Descrição
authMode	AuthMode	O modo de autorização para o qual as informações de autorização são solicitadas. Em quase todos os casos, o valor de authMode precisa ser ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), já que nenhum outro modo de autorização exige que os usuários concedam autorização.

Retornar

AuthorizationInfo: um objeto que pode fornecer informações sobre o status de autorização do usuário.

Recebe um token de identidade do OpenID Connect para o usuário efetivo, se o escopo openid tiver sido concedido. Esse escopo não é incluído por padrão e precisa ser adicionado como um escopo explícito no arquivo de manifesto para ser solicitado. Inclua os escopos https://www.googleapis.com/auth/userinfo.email ou https://www.googleapis.com/auth/userinfo.profile para retornar mais informações do usuário no token.

O token de ID retornado é um token da Web JSON (JWT) codificado e precisa ser decodificado para extrair informações. Os exemplos a seguir mostram como decodificar o token e extrair o ID do perfil do Google do usuário efetivo.

const idToken = ScriptApp.getIdentityToken();
const body = idToken.split('.')[1];
const decoded = Utilities
                    .newBlob(
                        Utilities.base64Decode(body),
                        )
                    .getDataAsString();
const payload = JSON.parse(decoded);

Logger.log(`Profile ID: ${payload.sub}`);

Consulte a documentação do OpenID Connect para conferir a lista completa de campos (declarações) retornados.

Retornar

String: o token de identidade, se disponível. Caso contrário, null.

Retorna um valor de tipo enumerado que indica como o script foi instalado como um complemento para o usuário atual, por exemplo, se o usuário o instalou pessoalmente na Chrome Web Store ou se um administrador de domínio o instalou para todos os usuários.

Retornar

InstallationSource: a origem da instalação.

Recebe o token de acesso do OAuth 2.0 para o usuário efetivo. Se os escopos do OAuth do script forem suficientes para autorizar outra API do Google que normalmente exija o próprio fluxo do OAuth (como o Google Picker), os scripts poderão ignorar a segunda solicitação de autorização transmitindo esse token. O token expira após um período (no mínimo alguns minutos). Os scripts precisam processar falhas de autorização e chamar esse método para obter um novo token quando necessário.

O token retornado por esse método inclui apenas os escopos necessários para o script no momento. Os escopos que foram autorizados anteriormente, mas não são mais usados pelo script, não são incluídos no token retornado. Se outros escopos do OAuth forem necessários além do que o script exige, eles poderão ser especificados no arquivo de manifesto do script.

Retornar

String: uma representação de string do token do OAuth 2.0.

Recebe todos os acionadores instaláveis associados ao projeto e ao usuário atuais.

Logger.log(
    `Current project has ${ScriptApp.getProjectTriggers().length} triggers.`,
);

Retornar

Trigger[]: uma matriz dos acionadores do usuário atual associados a esse projeto.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/script.scriptapp

Recebe o ID exclusivo do projeto do script. Esse é o método preferencial para receber o identificador exclusivo do projeto de script, em vez de getProjectKey(). Esse ID pode ser usado em todos os lugares em que a chave do projeto foi fornecida anteriormente.

Retornar

String: o ID do projeto do script.

Recebe um objeto usado para controlar a publicação do script como um app da Web.

// Get the URL of the published web app.
const url = ScriptApp.getService().getUrl();

Retornar

Service: um objeto usado para observar e controlar a publicação do script como um app da Web.

Recebe todos os acionadores instaláveis pertencentes a esse usuário no documento fornecido, apenas para esse script ou complemento. Esse método não pode ser usado para conferir os acionadores anexados a outros scripts.

const doc = DocumentApp.getActiveDocument();
const triggers = ScriptApp.getUserTriggers(doc);
// Log the handler function for the first trigger in the array.
Logger.log(triggers[0].getHandlerFunction());

Parâmetros

Nome	Tipo	Descrição
document	Document	Um arquivo do Documentos Google que pode conter gatilhos instaláveis.

Retornar

Trigger[]: uma matriz de acionadores pertencentes a esse usuário no documento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/script.scriptapp

Recebe todos os acionadores instaláveis pertencentes a esse usuário no formulário fornecido, apenas para esse script ou complemento. Esse método não pode ser usado para conferir os acionadores anexados a outros scripts.

const form = FormApp.getActiveForm();
const triggers = ScriptApp.getUserTriggers(form);
// Log the trigger source for the first trigger in the array.
Logger.log(triggers[0].getTriggerSource());

Parâmetros

Nome	Tipo	Descrição
form	Form	Um arquivo do Google Formulários que pode conter gatilhos instaláveis.

Retornar

Trigger[]: uma matriz de acionadores pertencentes a esse usuário no formulário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/script.scriptapp

Recebe todos os acionadores instaláveis pertencentes a esse usuário na planilha especificada, apenas para este script ou complemento. Esse método não pode ser usado para conferir os acionadores anexados a outros scripts.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const triggers = ScriptApp.getUserTriggers(ss);
// Log the event type for the first trigger in the array.
Logger.log(triggers[0].getEventType());

Parâmetros

Nome	Tipo	Descrição
spreadsheet	Spreadsheet	Um arquivo do Planilhas Google que pode conter gatilhos instaláveis.

Retornar

Trigger[]: uma matriz de acionadores pertencentes a esse usuário na planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/script.scriptapp

Invalida a autorização do usuário efetivo para executar o script atual. Usado para invalidar todas as permissões do script atual. Isso é especialmente útil para funções marcadas como autorização única. Como as funções de autorização única só podem ser chamadas na primeira execução depois que o script adquiriu a autorização, se você quiser realizar uma ação depois, será necessário revogar qualquer autorização que o script tenha, para que o usuário possa ver a caixa de diálogo de autorização novamente.

ScriptApp.invalidateAuth();

Gera

Error: quando a invalidação falha.

Cria um builder para um token de estado que pode ser usado em uma API de callback (como um fluxo OAuth).

// Generate a callback URL, given the name of a callback function. The script
// does not need to be published as a web app; the /usercallback URL suffix
// replaces /edit in any script's URL.
function getCallbackURL(callbackFunction) {
  // IMPORTANT: Replace string below with the URL from your script, minus the
  // /edit at the end.
  const scriptUrl =
      'https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz';
  const urlSuffix = '/usercallback?state=';
  const stateToken = ScriptApp.newStateToken()
                         .withMethod(callbackFunction)
                         .withTimeout(120)
                         .createToken();
  return scriptUrl + urlSuffix + stateToken;
}

Na maioria dos fluxos OAuth2, o token state é transmitido diretamente para o endpoint de autorização, não como parte do URL do callback. O endpoint de autorização o transmite como parte do URL do callback.

Exemplo:

• O script redireciona o usuário para o URL de autorização do OAuth2: https://accounts.google.com/o/oauth2/auth?state=token_generated_with_this_method&callback_uri=https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz/usercallback&other_oauth2_parameters
• O usuário clica em "Autorizar", e a página de autorização OAuth2 redireciona o usuário de volta para https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz/usercallback?state=token_generated_with_this_method&other_params_that_include_tokens_or_grants
• O redirecionamento acima (de volta para http://script.google.com/...) faz com que a solicitação do navegador seja /usercallback, que invoca o método especificado por StateTokenBuilder.withMethod(method).

Retornar

StateTokenBuilder: um objeto usado para continuar o processo de criação de tokens de estado.

Inicia o processo de criação de um acionador instalável que, quando acionado, chama uma determinada função.

// Creates an edit trigger for a spreadsheet identified by ID.
ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3')
    .onEdit()
    .create();

Parâmetros

Nome	Tipo	Descrição
functionName	String	A função a ser chamada quando o acionador for acionado. É possível usar funções de bibliotecas incluídas, como Library.libFunction1.

Retornar

TriggerBuilder: um objeto usado para continuar o processo de criação de acionadores.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/script.scriptapp