Struttura del manifest

Questa pagina descrive la struttura dei dati JSON di primo livello del file manifest di Google 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 implementata come componente aggiuntivo di Google Workspace.

chat

object

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

Per le nuove app Chat, utilizza 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. Un'app di chat che richiede l'autorizzazione non può eseguire azioni finché l'utente non la autorizza. Per pubblicare un messaggio prima dell'autorizzazione, aggiungi un oggetto addToSpaceFallbackMessage al manifest. Se l'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 abilitate per l'utilizzo da parte del progetto di script.

exceptionLogging

string

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

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

object (ExecutionApi)

La configurazione dell'eseguibile 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 script.

runtimeVersion

string

La versione runtime utilizzata dallo script. Se omesso, lo script utilizza il runtime predefinito (STABLE). Le opzioni valide includono:

  • STABLE: runtime predefinito (al momento Rhino).
  • V8: runtime basato su V8.
  • DEPRECATED_ES5: runtime di Rhino. Questo valore impedisce 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 un valore ZoneId come "America/Denver".

urlFetchWhitelist[]

string

Un elenco di prefissi URL HTTPS. Se presente, qualsiasi endpoint URL recuperato deve corrispondere a un prefisso in questo elenco. Ciò contribuisce a 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, utilizzata se il progetto viene eseguito il deployment come app web.