Estrutura do manifesto

Esta página descreve o nível superior da estrutura de dados JSON do arquivo de manifesto de um projeto do Apps Script.

As subestruturas do manifesto são definidas em páginas separadas:

Manifesto

O nível superior da configuração do manifesto.

Representação 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)
  }
}
Campos
addOns

object (AddOns)

A configuração de recursos do projeto, se implantado como um complemento do Google Workspace.

chat

object

A configuração do projeto se ele for implantado como um app do Google Chat. Para configurar os detalhes do app do Chat, ative a API Google Chat. Para mais detalhes, consulte Configurar a API Google Chat.

O Apps Script processa a autorização no nível do script. Os apps de chat que exigem autorização não podem realizar nenhuma ação até que o usuário autorize o app. Para postar uma mensagem antes da autorização, adicione um objeto addToSpaceFallbackMessage ao manifesto. Se o app de chat exigir uma lógica de inicialização, talvez seja necessário duplicar essa lógica na ação onMessage.

O exemplo a seguir mostra um app do Chat que responde com uma mensagem de boas-vindas padrão quando um usuário o adiciona a um espaço do Chat:

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

dependencies

object (Dependencies)

A configuração de serviços avançados e bibliotecas ativados para uso pelo projeto de script.

exceptionLogging

string

O local em que as exceções são registradas. As configurações válidas são as seguintes:

  • NONE indica que as exceções não foram registradas.
  • STACKDRIVER indica que as exceções são registradas no Stackdriver.
executionApi

object (ExecutionApi)

A configuração executável da API do projeto do script. Ele só é usado se o projeto for implantado para execução de API.

oauthScopes[]

string

A definição de escopos de autorização usados pelo projeto de script.

runtimeVersion

string

A versão do ambiente de execução que o script está usando. Se esse campo não estiver presente no manifesto, o script vai usar o ambiente de execução padrão (STABLE). As opções válidas para esse campo são as seguintes:

  • STABLE indica o ambiente de execução padrão (atualmente Rhino).
  • V8 indica o ambiente de execução V8.
  • DEPRECATED_ES5 indica o ambiente de execução do Rhino. Definir esse valor também impede a migração automática para o V8.
sheets

object (Sheets)

A configuração de recursos que define as macros do Planilhas.

timeZone

string

O fuso horário do script em um dos valores de ZoneId disponíveis, como "America/Denver".

urlFetchWhitelist[]

string

Uma lista de prefixos de URL HTTPS. Se presente, qualquer endpoint de URL buscado precisa corresponder a um dos prefixos desta lista. Isso pode ajudar a proteger os dados do usuário. Esse campo é opcional para implantações de teste, mas é obrigatório para implantações. Saiba mais sobre como adicionar URLs à lista de permissões.

webapp

object (Webapp)

A configuração do app da Web do projeto do script, que só é usada se o projeto for implantado como um app da Web.