Struktura pliku manifestu

Na tej stronie opisujemy najwyższy poziom struktury danych JSON pliku manifestu projektu 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 zasobów projektu w przypadku wdrożenia jako dodatku do Google Workspace.

chat

object

Konfiguracja projektu w przypadku wdrożenia jako aplikacji Google Chat.

Uwaga: w przypadku nowych aplikacji do obsługi czatu zalecamy używanie pola addOns.chat. Jeśli utrzymujesz istniejącą aplikację Google Chat, która używa pola chat, powinien to być pusty obiekt.

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. Aplikacje do czatu, które wymagają autoryzacji, nie mogą wykonywać żadnych działań, dopóki użytkownik nie autoryzuje aplikacji do czatu. Aby opublikować wiadomość przed autoryzacją, możesz dodać obiekt addToSpaceFallbackMessage do pliku manifestu. Jeśli aplikacja Chat wymaga logiki inicjowania, może być konieczne zduplikowanie tej logiki w onMessage.

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

        "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 oznacza, że wyjątki nie są rejestrowane.
  • STACKDRIVER oznacza, że wyjątki są rejestrowane w Stackdriverze.
executionApi

object (ExecutionApi)

Konfiguracja wykonywalna 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 tego pola nie ma w manifeście, skrypt używa domyślnego środowiska wykonawczego (STABLE). Prawidłowe opcje tego pola to:

  • STABLE oznacza domyślne środowisko wykonawcze (obecnie Rhino).
  • V8 oznacza środowisko wykonawcze oparte na V8.
  • DEPRECATED_ES5 oznacza środowisko wykonawcze Rhino. Ustawienie tej wartości uniemożliwia też automatyczną migrację do wersji 8.
sheets

object (Sheets)

Konfiguracja zasobu, która definiuje makra Arkuszy.

timeZone

string

Strefa czasowa skryptu w jednej z dostępnych wartości ZoneId, np. „America/Denver”.
urlFetchWhitelist[]

string

Lista prefiksów adresów URL HTTPS. Jeśli występuje, każdy pobrany punkt końcowy adresu URL musi być zgodny z jednym z prefiksów na tej liście. Może to pomóc w ochronie danych 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, która jest używana tylko wtedy, gdy projekt jest wdrażany jako aplikacja internetowa.