Struttura del manifest

Questa pagina descrive il livello superiore della struttura di dati JSON del file manifest di un progetto Apps Script.

Le sottostrutture del manifest sono definite in pagine separate:

Manifest

Il livello superiore della configurazione del manifest.

Rappresentazione JSON
{
  "addOns": {
    object (AddOns)
  },
  "chat": {},
  "dependencies": {
    object (Dependencies)
  },
  "exceptionLogging": string,
  "executionApi": {
    object (ExecutionApi)
  },
  "oauthScopes": [
    string
  ],
  "runtimeVersion": string,
  "sheets": {
    object (Sheets)
  },
  "timeZone": string,
  "urlFetchWhitelist": [
    string
  ],
  "webapp": {
    object (Webapp)
  }
}
Campi
addOns

object (AddOns)

La configurazione delle risorse del progetto se viene implementato come componente aggiuntivo di Google Workspace.

chat

object

La configurazione del progetto se viene implementato come app Google Chat. Per configurare i dettagli dell'app Chat, devi attivare l'API Google Chat. Per maggiori dettagli, consulta Configurare l'API Google Chat.

Apps Script gestisce l'autorizzazione a livello di script. Le app di chat che richiedono l'autorizzazione non possono eseguire alcuna azione finché l'utente non autorizza l'app di chat. Per pubblicare un messaggio prima dell'autorizzazione, puoi aggiungere un oggetto addToSpaceFallbackMessage al manifest. Se la tua app di Chat richiede una logica di inizializzazione, potresti dover duplicare questa logica nell'azione onMessage.

L'esempio seguente mostra un'app Chat che risponde con un messaggio di benvenuto predefinito quando un utente la aggiunge a uno spazio di Chat:

        "chat": {
          "addToSpaceFallbackMessage": "Thank you for adding me!"
        }
        

dependencies

object (Dependencies)

La configurazione dei servizi avanzati e delle librerie abilitati per l'utilizzo da parte del progetto di script.

exceptionLogging

string

La posizione in cui vengono registrate le eccezioni. Le impostazioni valide sono:

  • NONE indica che le eccezioni non vengono registrate.
  • STACKDRIVER indica che le eccezioni vengono registrate in Stackdriver.
executionApi

object (ExecutionApi)

La configurazione eseguibile dell'API del progetto di script. Questa opzione viene utilizzata solo se viene eseguito il deployment del progetto per l'esecuzione dell'API.

oauthScopes[]

string

La definizione degli ambiti di autorizzazione utilizzati dal progetto di script.

runtimeVersion

string

La versione del runtime utilizzata dallo script. Se questo campo non è presente nel manifest, lo script utilizza il runtime predefinito (STABLE). Le opzioni valide per questo campo sono le seguenti:

  • STABLE indica il runtime predefinito (attualmente Rhino).
  • V8 indica il runtime basato su V8.
  • DEPRECATED_ES5 indica il runtime di Rhino. L'impostazione di questo valore impedisce anche la migrazione automatica alla versione 8.
sheets

object (Sheets)

La configurazione della risorsa che definisce le macro di Fogli.

timeZone

string

Il fuso orario dello script in uno dei valori disponibili per ZoneId, ad esempio "America/Denver".

urlFetchWhitelist[]

string

Un elenco di prefissi degli URL HTTPS. Se presente, qualsiasi endpoint URL recuperato deve corrispondere a uno dei prefissi in questo elenco. Ciò può contribuire a proteggere i dati utente. Questo campo è facoltativo per i deployment di test, ma è obbligatorio per i deployment. Scopri di più su come inserire gli URL nella lista consentita.

webapp

object (Webapp)

La configurazione dell'app web del progetto di script, utilizzata solo se viene eseguito il deployment del progetto come app web.