Script Service

Script

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.