Aufbau eines Manifests

Auf dieser Seite wird die JSON-Datenstruktur der Manifestdatei eines Apps Script-Projekts auf oberster Ebene beschrieben.

Die Unterstrukturen des Manifests werden auf separaten Seiten definiert:

Manifest

Die oberste Ebene der Manifestkonfiguration.

JSON-Darstellung
{
  "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)
  }
}
Felder
addOns

object (AddOns)

Die Ressourcenkonfiguration des Projekts, wenn es als Google Workspace-Add-on bereitgestellt wird.

chat

object

Die Konfiguration des Projekts, wenn es als Google Chat-App bereitgestellt wird. Wenn Sie die Details der Chat-App konfigurieren möchten, müssen Sie die Google Chat API aktivieren. Weitere Informationen finden Sie unter Google Chat API konfigurieren.

In Apps Script erfolgt die Autorisierung auf Scriptebene. Chat-Apps, für die eine Autorisierung erforderlich ist, können erst dann Aktionen ausführen, wenn der Nutzer die Chat-App autorisiert hat. Wenn Sie eine Nachricht vor der Autorisierung posten möchten, können Sie dem Manifest ein addToSpaceFallbackMessage-Objekt hinzufügen. Wenn für Ihre Chat-App eine Initialisierungslogik erforderlich ist, müssen Sie diese Logik möglicherweise in der Aktion onMessage duplizieren.

Im folgenden Beispiel wird eine Chat-App gezeigt, die mit einer Standard-Willkommensnachricht antwortet, wenn ein Nutzer sie einem Chatbereich hinzufügt:

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

dependencies

object (Dependencies)

Die Konfiguration von erweiterten Diensten und Bibliotheken, die für die Verwendung durch das Scriptprojekt aktiviert sind.

exceptionLogging

string

Der Speicherort, an dem Ausnahmen protokolliert werden. Folgende Einstellungen sind zulässig:

  • NONE gibt an, dass Ausnahmen nicht protokolliert werden.
  • STACKDRIVER gibt an, dass Ausnahmen in Stackdriver protokolliert werden.
executionApi

object (ExecutionApi)

Die ausführbare API-Konfiguration des Scriptprojekts. Dieser Wert wird nur verwendet, wenn das Projekt für die API-Ausführung bereitgestellt wird.

oauthScopes[]

string

Die Definition der Berechtigungsbereiche, die vom Scriptprojekt verwendet werden.

runtimeVersion

string

Die Laufzeitversion, die vom Script verwendet wird. Wenn dieses Feld nicht im Manifest vorhanden ist, verwendet das Script die Standardlaufzeit (STABLE). Gültige Optionen für dieses Feld sind:

  • STABLE gibt die Standardlaufzeit an (aktuell Rhino).
  • V8 gibt die V8-Laufzeit an.
  • DEPRECATED_ES5 steht für die Rhino-Laufzeit. Außerdem wird dadurch die automatische Migration zu V8 verhindert.
sheets

object (Sheets)

Die Ressourcenkonfiguration, die Google Tabellen-Makros definiert.

timeZone

string

Die Script-Zeitzone in einem der verfügbaren Werte für ZoneId, z. B. „America/Denver“.

urlFetchWhitelist[]

string

Eine Liste von HTTPS-URL-Präfixen. Falls vorhanden, muss jeder abgerufene URL-Endpunkt mit einem der Präfixe in dieser Liste übereinstimmen. Dies kann zum Schutz von Nutzerdaten beitragen. Dieses Feld ist für Testbereitstellungen optional, für Bereitstellungen jedoch erforderlich. Weitere Informationen zum Setzen von URLs auf die Zulassungsliste

webapp

object (Webapp)

Die Webanwendungskonfiguration des Scriptprojekts, die nur verwendet wird, wenn das Projekt als Webanwendung bereitgestellt wird.