Aufbau eines Manifests

Auf dieser Seite wird die JSON-Datenstruktur der Manifestdatei eines Apps Script-Projekts auf oberster Ebene beschrieben. Im Manifest werden die Funktion oder der Zweck des Apps Script-Projekts definiert.

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.

Hinweis:Für neue Chat-Apps empfehlen wir, stattdessen das Feld addOns.chat zu verwenden. Wenn Sie eine vorhandene Chat-App verwalten, in der das Feld chat verwendet wird, sollte es ein leeres Objekt sein.

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.

Apps Script verarbeitet die Autorisierung auf Skriptebene. Chat-Apps, für die eine Autorisierung erforderlich ist, können keine Aktionen ausführen, bis der Nutzer die Chat-App autorisiert hat. Wenn Sie vor der Autorisierung eine Nachricht 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 Skriptprojekt aktiviert sind.

exceptionLogging

string

Der Ort, an dem Ausnahmen protokolliert werden. Gültige Einstellungen sind:

  • 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 Skriptprojekts. Dies wird nur verwendet, wenn das Projekt für die API-Ausführung bereitgestellt wird.

oauthScopes[]

string

Die Definition der Autorisierungsbereiche, die vom Skriptprojekt verwendet werden.

runtimeVersion

string

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

  • STABLE gibt die Standardlaufzeit an (derzeit Rhino).
  • V8 gibt die V8-basierte Laufzeit an.
  • DEPRECATED_ES5 gibt die Rhino-Laufzeit an. Wenn Sie diesen Wert festlegen, wird auch die automatische Migration zu V8 verhindert.
sheets

object (Sheets)

Die Ressourcenkonfiguration, die Sheets-Makros definiert.

timeZone

string

Die Zeitzone des Skripts in einem der verfügbaren ZoneId-Werte, z. B. „America/Denver“.
urlFetchWhitelist[]

string

Eine Liste mit HTTPS-URL-Präfixen. Sofern vorhanden, muss jeder abgerufene URL-Endpunkt mit einem der Präfixe in dieser Liste übereinstimmen. So können Nutzerdaten besser geschützt werden. 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 Skriptprojekts, die nur verwendet wird, wenn das Projekt als Webanwendung bereitgestellt wird.