Structure du fichier manifeste

Cette page décrit le niveau supérieur de la structure de données JSON du fichier manifeste d'un projet Apps Script. Le fichier manifeste définit la fonction ou l'objectif du projet Apps Script.

Représentation 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)
  }
}
Champs
addOns

object (AddOns)

Configuration des ressources du projet s'il est déployé en tant que module complémentaire Google Workspace.

chat

object

Configuration du projet s'il est déployé en tant qu' application Google Chat.

Remarque : Pour les nouvelles applications Chat, nous vous recommandons d'utiliser plutôt le champ addOns.chat. Si vous gérez une application Chat existante qui utilise le champ chat, il doit s'agir d'un objet vide.

Pour configurer les détails de l'application Chat, vous devez activer l'API Google Chat. Pour en savoir plus, consultez Configurer l'API Google Chat.

Apps Script gère l'autorisation au niveau du script. Les applications de chat qui nécessitent une autorisation ne peuvent effectuer aucune action tant que l'utilisateur n'a pas autorisé l'application de chat. Pour publier un message avant l'autorisation, vous pouvez ajouter un objet addToSpaceFallbackMessage au fichier manifeste. Si votre application Chat nécessite une logique d'initialisation, vous devrez peut-être dupliquer cette logique dans l'action onMessage.

L'exemple suivant montre une application Chat qui répond avec un message de bienvenue par défaut lorsqu'un utilisateur l'ajoute à un espace Chat :

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

dependencies

object (Dependencies)

Configuration des services avancés et des bibliothèques activés pour être utilisés par le projet de script.

exceptionLogging

string

Emplacement où les exceptions sont consignées. Les paramètres valides sont les suivants :

  • NONE indique que les exceptions ne sont pas consignées.
  • STACKDRIVER indique que les exceptions sont consignées dans Stackdriver.
executionApi

object (ExecutionApi)

Configuration exécutable de l'API du projet de script. Ce paramètre n'est utilisé que si le projet est déployé pour l'exécution de l'API.

oauthScopes[]

string

Définition des scopes d'autorisation utilisés par le projet de script.

runtimeVersion

string

La version d'exécution utilisée par le script. Si ce champ n'est pas présent dans le fichier manifeste, le script utilise l'environnement d'exécution par défaut (STABLE). Les options valides pour ce champ sont les suivantes :

  • STABLE indique l'environnement d'exécution par défaut (actuellement Rhino).
  • V8 indique l'environnement d'exécution optimisé par V8.
  • DEPRECATED_ES5 indique le runtime Rhino. Définir cette valeur empêche également la migration automatique vers V8.
sheets

object (Sheets)

Configuration de la ressource qui définit les macros Sheets.

timeZone

string

Le fuseau horaire du script dans l'une des valeurs ZoneId disponibles, comme "America/Denver".
urlFetchWhitelist[]

string

Liste des préfixes d'URL HTTPS. Si un point de terminaison d'URL est récupéré, il doit correspondre à l'un des préfixes de cette liste. Cela peut aider à protéger les données utilisateur. Ce champ est facultatif pour les déploiements de test, mais obligatoire pour les déploiements. En savoir plus sur l'ajout d'URL à la liste d'autorisation

webapp

object (Webapp)

Configuration de l'application Web du projet de script, qui n'est utilisée que si le projet est déployé en tant qu'application Web.