Estrutura do manifesto

Esta página descreve o nível superior de uma estrutura de dados JSON do arquivo de manifesto de um projeto do 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 ele for implantado como um complemento do Google Workspace.

chat

object

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

Observação:para novos apps do Chat, recomendamos usar o campo addOns.chat. Se você estiver mantendo um app do Chat que usa o campo chat, ele precisa ser um objeto vazio.

Para configurar os detalhes do app do 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. 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 do Chat exigir 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 ativadas 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 são registradas.
  • STACKDRIVER indica que as exceções são registradas no Stackdriver.
executionApi

object (ExecutionApi)

A configuração executável da API do projeto de script. Isso só é 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 esse campo não estiver presente no manifesto, o script 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 com tecnologia V8.
  • DEPRECATED_ES5 indica o ambiente de execução do Rhino. Definir esse valor também impede a migração automática para a V8.
sheets

object (Sheets)

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

timeZone

string

O fuso horário do script em um dos valores 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 dessa 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, que só é usada se o projeto for implantado como um app da Web.