DocumentProperties enquanto se desenvolve o Script

Muitas vezes ao desenvolvermos um Google Apps Script, precisamos fazer testes em funções e com isso podemos esbarrar em propriedades não disponíveis, como a Document Properties. Neste tópico irei sugerir uma alternativa para este problema.

Problema

Estou desenvolvendo uma aplicação que utiliza Document Properties de Properties Service, mas quando tento testa-la através da IDE do GAS acontece o seguinte erro:

DocumentPropertiesNull

TypeError: Cannot call method “getProperty” of null. (line 6, file “Code”)

Isso ocorre porque Properties Service só retorna o Objeto Document Properties quando o método getDocumentProperties é chamado a partir de um Documento.

Solução

Caso teste da aplicação seja feito na IDE será utilizado User Properties, caso contrário utilizará Document Properties.

Passo 1

Crie método com nome getDocumentProperties em um arquivo Util.gs ou mesmo em Code.gs.
Conteúdo do mesmo deverá ser o seguinte:

Utilize a função getDocumentProperties ao invés de utilizar PropertiesService.getDocumentProperties.

Resultado

Com isto você consegue economizar de tempo e reescreve menos o código.