Struktura pliku manifestu

Ta strona opisuje strukturę danych JSON na najwyższym poziomie pliku manifestu projektu Apps Script.

Podstruktury pliku manifestu są definiowane na osobnych stronach:

Plik manifestu

Najwyższy poziom konfiguracji pliku manifestu.

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, jeśli jest on wdrożony jako dodatek do Google Workspace.

chat

object

Konfigurację projektu, jeśli jest on wdrożony jako aplikacja Google Chat. Aby skonfigurować szczegóły aplikacji Chat, musisz włączyć interfejs Google Chat API. Więcej informacji znajdziesz w artykule Konfigurowanie interfejsu Google Chat API.

Aplikacja 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ć do pliku manifestu obiekt addToSpaceFallbackMessage. Jeśli Twoja aplikacja Google Chat wymaga logiki inicjowania, może być konieczne jej zduplikowanie w działaniu onMessage.

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

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

dependencies

object (Dependencies)

Konfiguracja usług zaawansowanychbibliotek włączonych do użytku przez projekt skryptu.

exceptionLogging

string

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

  • NONE oznacza, że wyjątki nie są rejestrowane.
  • STACKDRIVER wskazuje, że wyjątki są rejestrowane w Stackdriver.
executionApi

object (ExecutionApi)

Konfiguracja skompilowanego pliku wykonywalnego interfejsu API projektu skryptu. Jest on używany tylko wtedy, gdy projekt jest wdrażany do wykonania interfejsu API.

oauthScopes[]

string

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

runtimeVersion

string

Wersja środowiska wykonawczego używana przez skrypt. Jeśli to pole nie jest obecne w pliku manifestu, skrypt używa domyślnego środowiska wykonawczego (STABLE). Dostępne opcje tego pola to:

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

object (Sheets)

Konfiguracja zasobu definiująca 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 pobierany punkt końcowy adresu URL musi być zgodny z jednym z prefiksów 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 umieszczaniu adresów URL na liście dozwolonych.

webapp

object (Webapp)

Konfiguracja aplikacji internetowej projektu skryptu, która jest używana tylko wtedy, gdy projekt jest wdrażany jako aplikacja internetowa.