Struktura pliku manifestu

Na tej stronie opisujemy najwyższy poziom struktury danych JSON pliku manifestu Google Apps Script. Plik manifestu określa funkcję lub przeznaczenie projektu Apps Script.

Zapis 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)
  }
}
Pola
addOns

object (AddOns)

Konfiguracja zasobu projektu wdrożonego jako dodatek do Google Workspace.

chat

object

Konfiguracja projektu w przypadku wdrożenia jako aplikacji do obsługi czatu w Google Chat.

W przypadku nowych aplikacji Chat użyj pola addOns.chat. Jeśli masz istniejącą aplikację Google Chat, która korzysta z pola chat, powinno ono być pustym obiektem.

Aby skonfigurować szczegóły aplikacji do obsługi czatu, musisz włączyć interfejs Google Chat API. Szczegółowe informacje znajdziesz w artykule Konfigurowanie interfejsu Google Chat API.

Apps Script obsługuje autoryzację na poziomie skryptu. Aplikacja do obsługi czatu, która wymaga autoryzacji, nie może wykonywać działań, dopóki użytkownik jej nie autoryzuje. Aby opublikować wiadomość przed autoryzacją, dodaj do pliku manifestu obiekt addToSpaceFallbackMessage. Jeśli aplikacja do obsługi czatu wymaga logiki inicjowania, może być konieczne powielenie tej logiki w onMessagedziałaniu.

Poniższy przykład pokazuje aplikację do obsługi czatu, która odpowiada domyślną wiadomością powitalną, gdy użytkownik doda ją do pokoju czatu:

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

object (Dependencies)

Konfiguracja usług zaawansowanych i bibliotek włączonych do użytku w projekcie skryptu.

exceptionLogging

string

Lokalizacja, w której rejestrowane są wyjątki. Prawidłowe ustawienia to:

  • NONE: Wyjątki nie są rejestrowane.
  • STACKDRIVER: Wyjątki są rejestrowane w usłudze Stackdriver.
executionApi

object (ExecutionApi)

Konfiguracja pliku wykonywalnego interfejsu API projektu skryptu. Jest on używany tylko wtedy, gdy projekt jest wdrażany na potrzeby wykonywania interfejsu API.

oauthScopes[]

string

Definicja zakresów autoryzacji używanych przez projekt skryptu.

runtimeVersion

string

Wersja środowiska wykonawczego, z której korzysta skrypt. Jeśli zostanie pominięta, skrypt użyje domyślnego środowiska wykonawczego (STABLE). Dostępne opcje to:

  • STABLE: domyślne środowisko wykonawcze (obecnie Rhino).
  • V8: środowisko wykonawcze oparte na V8.
  • DEPRECATED_ES5: środowisko wykonawcze Rhino. Ta wartość uniemożliwia automatyczną migrację do wersji 8.
sheets

object (Sheets)

Konfiguracja zasobu definiująca makra Arkuszy.

timeZone

string

Strefa czasowa skryptu w wartości ZoneId, np. „America/Denver”.
urlFetchWhitelist[]

string

Lista prefiksów adresów URL HTTPS. Jeśli jest obecny, każdy pobrany punkt końcowy adresu URL musi pasować do prefiksu na tej liście. Pomaga to chronić dane użytkowników. To pole jest opcjonalne w przypadku wdrożeń testowych, ale wymagane w przypadku wdrożeń. Dowiedz się więcej o dodawaniu adresów URL do listy dozwolonych.

webapp

object (Webapp)

Konfiguracja aplikacji internetowej projektu skryptu, używana, jeśli projekt jest wdrażany jako aplikacja internetowa.