Questa pagina è stata tradotta dall'API Cloud Translation.

Script Service

Questo servizio fornisce l'accesso agli attivatori e alla pubblicazione degli script.

Corsi

Nome	Breve descrizione
`AuthMode`	Un'enumerazione che identifica le categorie di servizi autorizzati che Apps Script è in grado di eseguire tramite una funzione attivata.
`AuthorizationInfo`	Un oggetto che verifica se l'utente ha concesso l'autorizzazione per gli ambiti richiesti dello script.
`AuthorizationStatus`	Un'enumerazione che indica lo stato di autorizzazione di uno script.
`CalendarTriggerBuilder`	Generatore di trigger di calendario.
`ClockTriggerBuilder`	Un generatore di trigger a tempo.
`DocumentTriggerBuilder`	Un generatore di trigger per i documenti.
`EventType`	Un'enumerazione che indica il tipo di evento attivato.
`FormTriggerBuilder`	Un generatore di trigger per i moduli.
`InstallationSource`	Un'enumerazione che indica in che modo lo script è stato installato come componente aggiuntivo per l'utente corrente.
`ScriptApp`	Accedere e manipolare la pubblicazione e gli attivatori degli script.
`Service`	Accedere e manipolare la pubblicazione degli script.
`SpreadsheetTriggerBuilder`	Generatore di trigger per i fogli di lavoro.
`StateTokenBuilder`	Consente agli script di creare token di stato che possono essere utilizzati nelle API di callback (come i flussi OAuth).
`Trigger`	Un attivatore di script.
`TriggerBuilder`	Un generatore generico per gli attivatori di script.
`TriggerSource`	Un'enumerazione che indica la sorgente dell'evento che attiva l'attivatore.

`AuthMode`

Proprietà

Proprietà	Tipo	Descrizione
`NONE`	`Enum`	Una modalità che non consente l'accesso a servizi che richiedono l'autorizzazione.
`CUSTOM_FUNCTION`	`Enum`	Una modalità che consente l'accesso a un sottoinsieme limitato di servizi da utilizzare nelle funzioni di un foglio di lavoro personalizzato.
`LIMITED`	`Enum`	Una modalità che consente l'accesso a un sottoinsieme limitato di servizi.
`FULL`	`Enum`	Una modalità che consente l'accesso a tutti i servizi che richiedono l'autorizzazione.

`AuthorizationInfo`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getAuthorizationStatus()`	`AuthorizationStatus`	Restituisce un valore che indica se l'utente deve autorizzare questo script a utilizzare uno o più servizi (ad es. `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String`	Recupera l'URL di autorizzazione che può essere utilizzato per concedere l'accesso allo script.
`getAuthorizedScopes()`	`String[]`	Restituisce un elenco di ambiti autorizzati per lo script.

`AuthorizationStatus`

Proprietà

Proprietà	Tipo	Descrizione
`REQUIRED`	`Enum`	L'utente deve autorizzare questo script a utilizzare uno o più servizi.
`NOT_REQUIRED`	`Enum`	L'utente ha concesso a questo script tutte le autorizzazioni attualmente richieste.

`CalendarTriggerBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`create()`	`Trigger`	Crea e restituisce l'attivatore.
`onEventUpdated()`	`CalendarTriggerBuilder`	Specifica un attivatore che si attiva quando una voce del calendario viene creata, aggiornata o eliminata.

`ClockTriggerBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`after(durationMilliseconds)`	`ClockTriggerBuilder`	Specifica la durata minima (in millisecondi) dopo l'ora corrente in cui viene eseguito l'attivatore.
`at(date)`	`ClockTriggerBuilder`	Specifica quando viene eseguito l'attivatore.
`atDate(year, month, day)`	`ClockTriggerBuilder`	Specifica che l'attivatore viene attivato nella data specificata, per impostazione predefinita intorno a mezzanotte (+/- 15 minuti).
`atHour(hour)`	`ClockTriggerBuilder`	Specifica l'ora in cui viene eseguito l'attivatore.
`create()`	`Trigger`	Crea l'attivatore.
`everyDays(n)`	`ClockTriggerBuilder`	Specifica di eseguire l'attivatore ogni `n` giorni.
`everyHours(n)`	`ClockTriggerBuilder`	Specifica di eseguire l'attivatore ogni `n` ore.
`everyMinutes(n)`	`ClockTriggerBuilder`	Specifica di eseguire l'attivatore ogni `n` minuti.
`everyWeeks(n)`	`ClockTriggerBuilder`	Specifica di eseguire l'attivatore ogni `n` settimane.
`inTimezone(timezone)`	`ClockTriggerBuilder`	Specifica il fuso orario per le date/l'ora specificate quando viene eseguito l'attivatore.
`nearMinute(minute)`	`ClockTriggerBuilder`	Specifica il minuto in cui viene eseguito l'attivatore (più o meno 15 minuti).
`onMonthDay(day)`	`ClockTriggerBuilder`	Specifica la data del mese in cui viene eseguito l'attivatore.
`onWeekDay(day)`	`ClockTriggerBuilder`	Specifica il giorno della settimana in cui viene eseguito l'attivatore.

`DocumentTriggerBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`create()`	`Trigger`	Crea e restituisce il nuovo attivatore.
`onOpen()`	`DocumentTriggerBuilder`	Specifica un attivatore che verrà attivato quando il documento viene aperto.

`EventType`

Proprietà

Proprietà	Tipo	Descrizione
`CLOCK`	`Enum`	L'attivatore viene attivato quando l'evento basato sul tempo raggiunge un momento specifico.
`ON_OPEN`	`Enum`	L'attivatore viene attivato quando l'utente apre il file di Documenti, Fogli o Moduli Google.
`ON_EDIT`	`Enum`	L'attivatore viene attivato quando l'utente modifica il file di Fogli Google (ad esempio inserendo un nuovo valore in una cella, che viene conteggiato come modifica anziché come variazione).
`ON_FORM_SUBMIT`	`Enum`	L'attivatore viene attivato quando l'utente risponde a un modulo Google.
`ON_CHANGE`	`Enum`	L'attivatore viene attivato quando l'utente modifica il file di Fogli Google (ad esempio aggiungendo una riga, che viene conteggiata come una modifica anziché una modifica).
`ON_EVENT_UPDATED`	`Enum`	L'attivatore viene attivato quando un evento viene creato, aggiornato o eliminato nel Google Calendar specificato.

`FormTriggerBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`create()`	`Trigger`	Crea e restituisce il nuovo attivatore.
`onFormSubmit()`	`FormTriggerBuilder`	Specifica un attivatore che verrà attivato quando viene inviata una risposta al modulo.
`onOpen()`	`FormTriggerBuilder`	Specifica un attivatore che verrà attivato quando viene aperta la visualizzazione di modifica del modulo.

`InstallationSource`

Proprietà

Proprietà	Tipo	Descrizione
`APPS_MARKETPLACE_DOMAIN_ADD_ON`	`Enum`	Il componente aggiuntivo è stato installato dall'amministratore per il dominio dell'utente.
`NONE`	`Enum`	Lo script non viene eseguito come componente aggiuntivo.
`WEB_STORE_ADD_ON`	`Enum`	Il componente aggiuntivo è stato installato dall'utente dal Chrome Web Store.

`ScriptApp`

Proprietà

Proprietà	Tipo	Descrizione
`AuthMode`	`AuthMode`	Un'enumerazione che identifica le categorie di servizi autorizzati che Apps Script è in grado di eseguire tramite una funzione attivata.
`AuthorizationStatus`	`AuthorizationStatus`	Un'enumerazione che indica lo stato di autorizzazione di uno script.
`EventType`	`EventType`	Un'enumerazione che indica il tipo di evento attivato.
`InstallationSource`	`InstallationSource`	Un'enumerazione che indica in che modo lo script è stato installato per l'utente come componente aggiuntivo.
`TriggerSource`	`TriggerSource`	Un'enumerazione che indica la sorgente dell'evento che attiva l'attivatore.
`WeekDay`	`Weekday`	Un'enumerazione che rappresenta i giorni della settimana.

Metodi

Metodo	Tipo restituito	Breve descrizione
`deleteTrigger(trigger)`	`void`	Rimuove l'attivatore specificato in modo che non venga più eseguito.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	Restituisce un oggetto che controlla se l'utente ha concesso l'autorizzazione per tutti i requisiti dello script.
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	Restituisce un oggetto che verifica se l'utente ha concesso l'autorizzazione per gli ambiti richiesti.
`getIdentityToken()`	`String`	Recupera un token di identità OpenID Connect per l'utente effettivo, se è stato concesso l'ambito `openid`.
`getInstallationSource()`	`InstallationSource`	Restituisce un valore enum che indica in che modo lo script è stato installato come componente aggiuntivo per l'utente corrente (ad esempio, se l'utente lo ha installato personalmente tramite il Chrome Web Store o se un amministratore di dominio lo ha installato per tutti gli utenti).
`getOAuthToken()`	`String`	Recupera il token di accesso OAuth 2.0 per l'utente effettivo.
`getProjectTriggers()`	`Trigger[]`	Recupera tutti gli attivatori installabili associati al progetto e all'utente corrente.
`getScriptId()`	`String`	Recupera l'ID univoco del progetto di script.
`getService()`	`Service`	Restituisce un oggetto utilizzato per controllare la pubblicazione dello script come app web.
`getUserTriggers(document)`	`Trigger[]`	Recupera tutti gli attivatori installabili di proprietà di questo utente nel documento specificato, solo per questo script o componente aggiuntivo.
`getUserTriggers(form)`	`Trigger[]`	Recupera tutti gli attivatori installabili di proprietà di questo utente nel modulo specificato, solo per questo script o componente aggiuntivo.
`getUserTriggers(spreadsheet)`	`Trigger[]`	Recupera tutti gli attivatori installabili di proprietà di questo utente nel foglio di lavoro specificato, solo per questo script o plug-in.
`invalidateAuth()`	`void`	Annullamento dell'autorizzazione di cui l'utente effettivo dispone per eseguire lo script corrente.
`newStateToken()`	`StateTokenBuilder`	Crea un generatore per un token di stato che può essere utilizzato in un'API di callback (ad esempio un flusso OAuth).
`newTrigger(functionName)`	`TriggerBuilder`	Avvia il processo di creazione di un trigger installabile che, quando viene attivato, chiama una determinata funzione.
`requireAllScopes(authMode)`	`void`	Verifica se l'utente ha concesso il consenso per tutti gli ambiti richiesti dallo script.
`requireScopes(authMode, oAuthScopes)`	`void`	Verifica se l'utente ha concesso il consenso per gli ambiti richiesti.

`Service`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getUrl()`	`String`	Restituisce l'URL dell'app web, se è stato eseguito il deployment, altrimenti restituisce `null`.
`isEnabled()`	`Boolean`	Restituisce `true` se lo script è accessibile come app web.

`SpreadsheetTriggerBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`create()`	`Trigger`	Crea e restituisce l'attivatore.
`onChange()`	`SpreadsheetTriggerBuilder`	Specifica un attivatore che verrà attivato quando i contenuti o la struttura del foglio di lavoro vengono modificati.
`onEdit()`	`SpreadsheetTriggerBuilder`	Specifica un attivatore che verrà attivato quando il foglio di lavoro viene modificato.
`onFormSubmit()`	`SpreadsheetTriggerBuilder`	Specifica un attivatore che verrà attivato quando nel foglio di lavoro viene inviato un modulo.
`onOpen()`	`SpreadsheetTriggerBuilder`	Specifica un attivatore che verrà attivato quando il foglio di lavoro viene aperto.

`StateTokenBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`createToken()`	`String`	Costruisce una rappresentazione di stringa criptata del token dello stato.
`withArgument(name, value)`	`StateTokenBuilder`	Aggiunge un argomento al token.
`withMethod(method)`	`StateTokenBuilder`	Imposta una funzione di callback.
`withTimeout(seconds)`	`StateTokenBuilder`	Imposta la durata (in secondi) di validità del token.

`Trigger`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getEventType()`	`EventType`	Restituisce il tipo di evento per cui viene attivato l'attivatore.
`getHandlerFunction()`	`String`	Restituisce la funzione che verrà chiamata quando viene attivato l'attivatore.
`getTriggerSource()`	`TriggerSource`	Restituisce l'origine degli eventi che attiveranno l'attivatore.
`getTriggerSourceId()`	`String`	Restituisce l'ID specifico dell'origine.
`getUniqueId()`	`String`	Restituisce un identificatore univoco che può essere utilizzato per distinguere gli attivatori tra loro.

`TriggerBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`forDocument(document)`	`DocumentTriggerBuilder`	Crea e restituisce un `DocumentTriggerBuilder` associato al documento specificato.
`forDocument(key)`	`DocumentTriggerBuilder`	Crea e restituisce un `DocumentTriggerBuilder` associato al documento con l'ID specificato.
`forForm(form)`	`FormTriggerBuilder`	Crea e restituisce un `FormTriggerBuilder` associato al modulo specificato.
`forForm(key)`	`FormTriggerBuilder`	Crea e restituisce un `FormTriggerBuilder` associato al modulo con l'ID specificato.
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	Crea e restituisce un `SpreadsheetTriggerBuilder` associato al foglio di lavoro specificato.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	Crea e restituisce un `SpreadsheetTriggerBuilder` associato al foglio di lavoro con l'ID specificato.
`forUserCalendar(emailId)`	`CalendarTriggerBuilder`	Restituisce un generatore per la creazione di trigger di calendario.
`timeBased()`	`ClockTriggerBuilder`	Crea e restituisce un `ClockTriggerBuilder` per la creazione di trigger basati sul tempo.

`TriggerSource`

Proprietà

Proprietà	Tipo	Descrizione
`SPREADSHEETS`	`Enum`	Fogli Google attiva l'attivatore.
`CLOCK`	`Enum`	Un evento basato sul tempo attiva l'attivatore.
`FORMS`	`Enum`	Moduli Google attiva l'attivatore.
`DOCUMENTS`	`Enum`	Documenti Google attiva l'attivatore.
`CALENDAR`	`Enum`	Google Calendar attiva l'attivatore.

Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.

Ultimo aggiornamento 2025-07-26 UTC.

Blog
Leggi il blog per sviluppatori di Google Workspace
Stack Overflow
Fare una domanda sotto il tag google-apps-script
Esempi di codice
Esplora i nostri esempi di codice o copiali per crearne uno
Video
Guarda i tutorial di Apps Script