Questa pagina è stata tradotta dall'API Cloud Translation.

Script Service

Questo servizio fornisce l'accesso ai trigger di script e alla pubblicazione di 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 per i trigger a tempo.
`DocumentTriggerBuilder`	Un generatore di trigger di documenti.
`EventType`	Un'enumerazione che indica il tipo di evento attivato.
`FormTriggerBuilder`	Un generatore per i trigger dei moduli.
`InstallationSource`	Un'enumerazione che indica come è stato installato lo script come componente aggiuntivo per l'utente corrente.
`ScriptApp`	Accedere e manipolare la pubblicazione e i trigger degli script.
`Service`	Accedere alla pubblicazione degli script e manipolarla.
`SpreadsheetTriggerBuilder`	Strumento di creazione per i trigger dei 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 generico generatore di trigger di script.
`TriggerSource`	Un'enumerazione che indica l'origine dell'evento che causa l'attivazione del trigger.

`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 personalizzate dei fogli di lavoro.
`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`	Recupera un valore che indica se l'utente deve autorizzare questo script a utilizzare uno o più servizi (ad esempio `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String\|null`	Recupera l'URL di autorizzazione che può essere utilizzato per concedere l'accesso allo script.
`getAuthorizedScopes()`	`String[]\|null`	Recupera 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 il trigger e lo restituisce.
`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 il trigger.
`at(date)`	`ClockTriggerBuilder`	Specifica quando viene eseguito l'attivatore.
`atDate(year, month, day)`	`ClockTriggerBuilder`	Specifica che il trigger viene attivato nella data indicata, per impostazione predefinita verso mezzanotte (+/- 15 minuti).
`atHour(hour)`	`ClockTriggerBuilder`	Specifica l'ora in cui viene eseguito l'attivatore.
`create()`	`Trigger`	Crea il trigger.
`everyDays(n)`	`ClockTriggerBuilder`	Specifica di eseguire l'attivatore ogni `n` giorni.
`everyHours(n)`	`ClockTriggerBuilder`	Specifica di eseguire il trigger ogni `n` ore.
`everyMinutes(n)`	`ClockTriggerBuilder`	Specifica di eseguire il trigger ogni `n` minuti.
`everyWeeks(n)`	`ClockTriggerBuilder`	Specifica di eseguire il trigger ogni `n` settimane.
`inTimezone(timezone)`	`ClockTriggerBuilder`	Specifica il fuso orario per la data/ora specificata in cui viene eseguito il trigger.
`nearMinute(minute)`	`ClockTriggerBuilder`	Specifica il minuto in cui viene eseguito il trigger (più o meno 15 minuti).
`onMonthDay(day)`	`ClockTriggerBuilder`	Specifica la data del mese in cui viene eseguito il trigger.
`onWeekDay(day)`	`ClockTriggerBuilder`	Specifica il giorno della settimana in cui viene eseguito il trigger.

`DocumentTriggerBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`create()`	`Trigger`	Crea e restituisce il nuovo trigger.
`onOpen()`	`DocumentTriggerBuilder`	Specifica un attivatore che verrà attivato all'apertura del documento.

`EventType`

Proprietà

Proprietà	Tipo	Descrizione
`CLOCK`	`Enum`	Il trigger viene attivato quando l'evento basato sul tempo raggiunge un momento specifico.
`ON_OPEN`	`Enum`	Il trigger si attiva quando l'utente apre il file di Documenti, Fogli o Moduli Google.
`ON_EDIT`	`Enum`	Il trigger viene attivato quando l'utente modifica il file Fogli Google (ad esempio inserendo un nuovo valore in una cella, che viene conteggiato come modifica anziché come cambiamento).
`ON_FORM_SUBMIT`	`Enum`	Il trigger si attiva quando l'utente risponde a un modulo Google.
`ON_CHANGE`	`Enum`	Il trigger viene attivato quando l'utente modifica il file Fogli Google (ad esempio aggiungendo una riga, che viene conteggiata come modifica anziché come modifica).
`ON_EVENT_UPDATED`	`Enum`	Il trigger viene attivato una volta che 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 trigger.
`onFormSubmit()`	`FormTriggerBuilder`	Specifica un attivatore che si attiverà quando una risposta viene inviata 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 come è stato installato lo script per l'utente come componente aggiuntivo.
`TriggerSource`	`TriggerSource`	Un'enumerazione che indica l'origine dell'evento che causa l'attivazione del trigger.
`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`	Recupera un oggetto che verifica se l'utente ha concesso l'autorizzazione per tutti i requisiti dello script.
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	Recupera un oggetto che verifica se l'utente ha concesso l'autorizzazione per gli ambiti richiesti.
`getIdentityToken()`	`String\|null`	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 come è stato installato lo script 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`	Ottiene il token di accesso OAuth 2.0 per l'utente effettivo.
`getProjectTriggers()`	`Trigger[]`	Recupera tutti i trigger installabili associati al progetto corrente e all'utente corrente.
`getScriptId()`	`String`	Recupera l'ID univoco del progetto script.
`getService()`	`Service`	Ottiene un oggetto utilizzato per controllare la pubblicazione dello script come app web.
`getUserTriggers(document)`	`Trigger[]`	Recupera tutti i trigger installabili di proprietà di questo utente nel documento specificato, solo per questo script o componente aggiuntivo.
`getUserTriggers(form)`	`Trigger[]`	Recupera tutti i trigger installabili di proprietà di questo utente nel modulo specificato, solo per questo script o componente aggiuntivo.
`getUserTriggers(spreadsheet)`	`Trigger[]`	Recupera tutti i trigger installabili di proprietà di questo utente nel foglio di lavoro specificato, solo per questo script o componente aggiuntivo.
`invalidateAuth()`	`void`	Annulla l'autorizzazione dell'utente effettivo per l'esecuzione dello script corrente.
`newStateToken()`	`StateTokenBuilder`	Crea un builder per un token di stato che può essere utilizzato in un'API di callback (come un flusso OAuth).
`newTrigger(functionName)`	`TriggerBuilder`	Avvia il processo di creazione di un trigger installabile che, quando 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 è stata implementata; altrimenti restituisce `null`.
`isEnabled()`	`Boolean`	Restituisce `true` se lo script è accessibile come app web.

`SpreadsheetTriggerBuilder`

Metodi

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

`StateTokenBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`createToken()`	`String`	Costruisce una rappresentazione di stringa criptata del token di 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) per cui il token è valido.

`Trigger`

Metodi

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

`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` collegato 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` collegato al modulo con l'ID specificato.
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	Crea e restituisce un `SpreadsheetTriggerBuilder` collegato al foglio di lavoro specificato.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	Crea e restituisce un oggetto `SpreadsheetTriggerBuilder` collegato al foglio di lavoro con l'ID specificato.
`forUserCalendar(emailId)`	`CalendarTriggerBuilder`	Restituisce un builder 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 il trigger.
`FORMS`	`Enum`	Moduli Google attiva il trigger.
`DOCUMENTS`	`Enum`	Documenti Google attiva l'attivatore.
`CALENDAR`	`Enum`	Google Calendar attiva il trigger.

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-12-11 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