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.

Les sous-structures du fichier manifeste sont définies sur des pages distinctes:

Fichier manifeste

Niveau supérieur de la configuration du fichier manifeste.

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 si celui-ci 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. Pour configurer les détails de l'application Chat, vous devez activer l'API Google Chat. Pour en savoir plus, consultez la section Configurer l'API Google Chat.

Apps Script gère l'autorisation au niveau du script. Les applications Chat qui nécessitent une autorisation ne peuvent effectuer aucune action tant que l'utilisateur n'a pas autorisé l'application 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 l'utilisation par le projet de script.

exceptionLogging

string

Emplacement où les exceptions sont enregistré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. Cette option n'est utilisée que si le projet est déployé pour l'exécution de l'API.

oauthScopes[]

string

Définition des champs d'application de l'autorisation utilisés par le projet de script.

runtimeVersion

string

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 V8.
  • DEPRECATED_ES5 indique l'environnement d'exécution Rhino. Définir cette valeur empêche également la migration automatique vers V8.
sheets

object (Sheets)

Configuration des ressources qui définit les macros Sheets.

timeZone

string

Fuseau horaire du script dans l'une des valeurs ZoneId disponibles, par exemple "America/Denver".
urlFetchWhitelist[]

string

Liste des préfixes d'URL HTTPS. Si elle est présente, tout point de terminaison d'URL extrait 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 tests, 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.