Questa pagina è stata tradotta dall'API Cloud Translation.

Script Service

Questo servizio fornisce accesso ai trigger 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 utilizzato per determinare se l'utente deve autorizzare questo script per utilizzare uno o più servizi e per fornire l'URL di una finestra di dialogo di autorizzazione.
`AuthorizationStatus`	Un'enumerazione che indica lo stato di autorizzazione di uno script.
`CalendarTriggerBuilder`	Builder per gli attivatori di calendario.
`ClockTriggerBuilder`	Un generatore di trigger orologio.
`DocumentTriggerBuilder`	Uno strumento di creazione per gli attivatori di documenti.
`EventType`	Un'enumerazione che indica il tipo di evento attivato.
`FormTriggerBuilder`	Uno strumento per la creazione di trigger di modulo.
`InstallationSource`	Un'enumerazione che indica come è stato installato lo script come componente aggiuntivo per l'utente corrente.
`ScriptApp`	Accedere e gestire la pubblicazione e gli attivatori degli script.
`Service`	Accedi alla pubblicazione degli script e manipolala.
`SpreadsheetTriggerBuilder`	Builder per gli attivatori dei fogli di lavoro.
`StateTokenBuilder`	Consente agli script di creare token di stato utilizzabili nelle API di callback (come i flussi OAuth).
`Trigger`	Un attivatore di script.
`TriggerBuilder`	Un generatore generico per i trigger di script.
`TriggerSource`	Un'enumerazione che indica l'origine dell'evento che causa l'attivazione dell'attivatore.

`AuthMode`

Proprietà

Proprietà	Tipo	Descrizione
`NONE`	`Enum`	Una modalità che non consente l'accesso ai 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`	Restituisce un valore che indica se l'utente deve autorizzare questo script per utilizzare uno o più servizi, ad esempio `ScriptApp.AuthorizationStatus.REQUIRED`.
`getAuthorizationUrl()`	`String`	Recupera l'URL di autorizzazione che può essere utilizzato per concedere l'accesso allo script.

`AuthorizationStatus`

Proprietà

Proprietà	Tipo	Descrizione
`REQUIRED`	`Enum`	L'utente deve autorizzare questo script per 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 di 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 attuale di esecuzione dell'attivatore.
`at(date)`	`ClockTriggerBuilder`	Specifica quando viene eseguito il trigger.
`atDate(year, month, day)`	`ClockTriggerBuilder`	Specifica che l'attivatore si attiva nella data specificata, per impostazione predefinita vicino a mezzanotte (+/- 15 minuti).
`atHour(hour)`	`ClockTriggerBuilder`	Specifica l'ora di esecuzione dell'attivatore.
`create()`	`Trigger`	Crea l'attivatore.
`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 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/ore specificate quando viene eseguito l'attivatore.
`nearMinute(minute)`	`ClockTriggerBuilder`	Specifica il minuto di esecuzione del trigger (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 trigger.
`onOpen()`	`DocumentTriggerBuilder`	Specifica un attivatore che si attiva all'apertura del documento.

`EventType`

Proprietà

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

`FormTriggerBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`create()`	`Trigger`	Crea e restituisce il nuovo trigger.
`onFormSubmit()`	`FormTriggerBuilder`	Specifica un attivatore che si attiva quando viene inviata una risposta al modulo.
`onOpen()`	`FormTriggerBuilder`	Specifica un attivatore che si attiverà all'apertura della 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 è in esecuzione 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 lo script è stato installato per l'utente come componente aggiuntivo.
`TriggerSource`	`TriggerSource`	Un'enumerazione che indica l'origine dell'evento che causa l'attivazione dell'attivatore.
`WeekDay`	`Weekday`	Un'enumerazione che rappresenta i giorni della settimana.

Metodi

Metodo	Tipo restituito	Breve descrizione
`deleteTrigger(trigger)`	`void`	Rimuove il trigger specificato in modo che non venga più eseguito.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	Restituisce un oggetto utilizzato per determinare se l'utente deve autorizzare questo script per utilizzare uno o più servizi e per fornire l'URL di una finestra di dialogo di autorizzazione.
`getIdentityToken()`	`String`	Restituisce 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 è stato installato da un amministratore di dominio per tutti gli utenti.
`getOAuthToken()`	`String`	Recupera il token di accesso OAuth 2.0 per l'utente effettivo.
`getProjectTriggers()`	`Trigger[]`	Recupera tutti i trigger installabili associati al progetto e all'utente corrente.
`getScriptId()`	`String`	Restituisce l'ID univoco del progetto di script.
`getService()`	`Service`	Restituisce un oggetto utilizzato per controllare la pubblicazione dello script come applicazione web.
`getUserTriggers(document)`	`Trigger[]`	Restituisce 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 formato 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 la validità dell'autorizzazione dell'utente effettivo 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 attivatore installabile che, se attivato, chiama una determinata funzione.

`Service`

Metodi

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

`SpreadsheetTriggerBuilder`

Metodi

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

`StateTokenBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`createToken()`	`String`	Crea una rappresentazione 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) di validità del token.

`Trigger`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getEventType()`	`EventType`	Restituisce il tipo di evento su cui si attiva l'attivatore.
`getHandlerFunction()`	`String`	Restituisce la funzione che verrà richiamata all'attivazione dell'attivatore.
`getTriggerSource()`	`TriggerSource`	Restituisce l'origine degli eventi che causeranno l'attivazione dell'attivatore.
`getTriggerSourceId()`	`String`	Restituisce l'ID specifico dell'origine.
`getUniqueId()`	`String`	Restituisce un identificatore univoco che può essere utilizzato per distinguere gli attivatori l'uno dall'altro.

`TriggerBuilder`

Metodi

Metodo	Tipo restituito	Breve descrizione
`forDocument(document)`	`DocumentTriggerBuilder`	Crea e restituisce un elemento `DocumentTriggerBuilder` legato 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 elemento `FormTriggerBuilder` collegato al modulo specificato.
`forForm(key)`	`FormTriggerBuilder`	Crea e restituisce un elemento `FormTriggerBuilder` collegato al modulo con l'ID specificato.
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	Crea e restituisce un elemento `SpreadsheetTriggerBuilder` collegato al foglio di lavoro specificato.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	Crea e restituisce un elemento `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 determina l'attivazione dell'attivatore.
`CLOCK`	`Enum`	Un evento a tempo determina l'attivazione dell'attivatore.
`FORMS`	`Enum`	Moduli Google determina l'attivazione dell'attivatore.
`DOCUMENTS`	`Enum`	Documenti Google determina l'attivazione dell'attivatore.
`CALENDAR`	`Enum`	Google Calendar determina l'attivazione dell'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 2023-12-01 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