Aufbau eines Manifests

Auf dieser Seite wird die JSON-Datenstruktur der Google Apps Script-Manifestdatei auf oberster Ebene beschrieben. Im Manifest wird 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 Konfiguration der Projektressource, wenn sie als Google Workspace-Add‑on bereitgestellt wird.

chat

object

Die Projektkonfiguration, wenn sie als Google Chat-App bereitgestellt wird.

Verwenden Sie für neue Chat-Apps stattdessen das Feld addOns.chat. Wenn Sie eine vorhandene Chat-App verwalten, in der das Feld chat verwendet wird, sollte es ein leeres Objekt sein.

Wenn Sie Details zur Google 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. Eine Chat-App, für die eine Autorisierung erforderlich ist, kann erst dann Aktionen ausführen, wenn der Nutzer sie autorisiert hat. Wenn Sie vor der Autorisierung eine Nachricht posten möchten, fügen Sie dem Manifest ein addToSpaceFallbackMessage-Objekt hinzu. 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 Google Chat-Gruppenbereich 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:

  • NONE: Ausnahmen werden nicht protokolliert.
  • STACKDRIVER: Ausnahmen werden in Stackdriver protokolliert.
executionApi

object (ExecutionApi)

Die ausführbare Konfiguration der Scriptprojekt-API. 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 nichts angegeben ist, wird die Standardlaufzeit (STABLE) verwendet. Gültige Optionen sind:

  • STABLE: Standardlaufzeit (derzeit Rhino).
  • V8: V8-basierte Laufzeit.
  • DEPRECATED_ES5: Rhino-Laufzeit. Dieser Wert verhindert die automatische Migration zu V8.
sheets

object (Sheets)

Die Ressourcenkonfiguration, die Sheets-Makros definiert.

timeZone

string

Die Zeitzone des Skripts in einem ZoneId-Wert wie „America/Denver“.
urlFetchWhitelist[]

string

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