Aufbau eines Manifests

Auf dieser Seite wird die JSON-Datenstruktur der obersten Ebene der Google Apps Script-Manifestdatei 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 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 stattd addOns.chat statt das Feld. Wenn Sie eine vorhandene Chat-App verwalten, die das chat Feld verwendet, sollte es ein leeres Objekt sein.

Wenn Sie Details zur 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 Ihre Chat-App eine Initialisierungslogik erfordert, müssen Sie diese Logik möglicherweise in der onMessage Aktion duplizieren.

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

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

object (Dependencies)

Die Konfiguration der erweiterten Dienste 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: Ausnahmen werden nicht protokolliert.
  • STACKDRIVER: Ausnahmen werden in Stackdriver protokolliert.
executionApi

object (ExecutionApi)

Die ausführbare Konfiguration der Skriptprojekt-API. Diese 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, verwendet das Skript die Standardlaufzeit (STABLE). Gültige Optionen sind:

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

object (Sheets)

Die Ressourcenkonfiguration, die Tabellen-Makros definiert.

timeZone

string

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

string

Eine Liste von HTTPS-URL-Präfixen. Wenn 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 Web-App-Konfiguration des Skriptprojekts, die verwendet wird, wenn das Projekt als Web-App bereitgestellt wird.