Estrutura do manifesto

Esta página descreve o nível superior da estrutura de dados JSON do arquivo de manifesto do Google Apps Script. O manifesto define a função ou a finalidade do projeto do Apps Script.

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 implantada como um complemento do Google Workspace.

chat

object

A configuração do projeto se for implantado como um app do Google Chat.

Para novos apps do Chat, use o campo addOns.chat em vez disso. Se você mantiver um app de chat que usa o campo chat, ele precisará ser um objeto vazio.

Para configurar os detalhes do app de chat, você precisa ativar 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. Um app de chat que exige autorização não pode realizar ações até que o usuário o autorize. Para postar uma mensagem antes da autorização, adicione um objeto addToSpaceFallbackMessage ao manifesto. Se o app do 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 de 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 ativadas para uso pelo projeto de script.

exceptionLogging

string

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

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

object (ExecutionApi)

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

oauthScopes[]

string

A definição dos 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 omitido, o script usará o ambiente de execução padrão (STABLE). As opções válidas incluem:

  • STABLE: ambiente de execução padrão (atualmente Rhino).
  • V8: ambiente de execução com tecnologia V8.
  • DEPRECATED_ES5: ambiente de execução do Rhino. Esse valor impede a migração automática para a V8.
sheets

object (Sheets)

A configuração de recursos que define macros do Google Sheets.

timeZone

string

O fuso horário do script em um valor ZoneId, como "America/Denver".
urlFetchWhitelist[]

string

Uma lista de prefixos de URL HTTPS. Se presente, qualquer endpoint de URL buscado precisa corresponder a um prefixo nesta lista. Isso ajuda 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 de script, usada se o projeto for implantado como um app da Web.