Struttura del manifest

Questa pagina descrive il livello superiore della struttura dei dati JSON del file manifest di un progetto Apps Script. Il manifest definisce la funzione o lo scopo del progetto Apps Script.

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 Google Workspace.

chat

object

La configurazione del progetto se viene implementato come app Google Chat.

Nota:per le nuove app di chat, ti consigliamo di utilizzare invece il campo addOns.chat. Se gestisci un'app Chat esistente che utilizza il campo chat, deve essere un oggetto vuoto.

Per configurare i dettagli dell'app di chat, devi abilitare l'API Google Chat. Per maggiori dettagli, vedi 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 l'app 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 abilitate per l'utilizzo da parte del progetto di script.

exceptionLogging

string

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

  • 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. Questo viene utilizzato solo se il progetto viene implementato per l'esecuzione dell'API.

oauthScopes[]

string

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

runtimeVersion

string

La versione 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 Rhino. Se imposti questo valore, viene impedita anche la migrazione automatica alla versione 8.
sheets

object (Sheets)

La configurazione delle risorse che definisce le macro di Fogli.

timeZone

string

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

string

Un elenco di prefissi URL HTTPS. Se presente, qualsiasi endpoint URL recuperato deve corrispondere a uno dei prefissi di questo elenco. In questo modo, puoi proteggere i dati degli utenti. Questo campo è facoltativo per le implementazioni di test, ma è obbligatorio per le implementazioni. Scopri di più sull'inserimento degli URL nella lista consentita.

webapp

object (Webapp)

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