Base Service

Camadas

Esse serviço fornece acesso a informações do usuário, como endereços de e-mail e nomes de usuário. Ele também controla registros de script e caixas de diálogo em aplicativos do Google Workspace.

Classes

NomeBreve descrição
BlobUm objeto de troca de dados para serviços do Apps Script.
BlobSourceInterface para objetos que podem exportar dados como um Blob.
BrowserEssa classe fornece acesso a caixas de diálogo específicas das Planilhas Google.
ButtonUm tipo enumerado que representa botões de diálogo localizados e predeterminados retornados por um alert ou PromptResponse.getSelectedButton() para indicar em qual botão em uma caixa de diálogo o usuário clicou.
ButtonSetUm tipo enumerado que representa conjuntos localizados predefinidos de um ou mais botões de caixa de diálogo que podem ser adicionados a um alert ou a um prompt.
ColorTypeTipos de cores
LoggerEssa classe permite que o desenvolvedor grave no registro de execução e no Google Cloud Logging se o script estiver associado a um projeto padrão do Cloud.
MenuUm menu personalizado em uma instância da interface do usuário de um app do Google.
MimeTypeUma enumeração que fornece acesso a declarações de tipo MIME sem digitar as strings explicitamente.
MonthUm tipo enumerado que representa os meses do ano.
PromptResponseUma resposta a uma caixa de diálogo prompt exibida no ambiente da interface do usuário de um app do Google.
RgbColorUma cor definida por canais de cor vermelho, verde e azul.
SessionA classe Session oferece acesso às informações da sessão, como o endereço de e-mail do usuário (em algumas circunstâncias) e a configuração de idioma.
UiUma instância do ambiente de interface do usuário de um app Google que permite que o script adicione recursos como menus, caixas de diálogo e barras laterais.
UserRepresentação de um usuário, adequada para programação.
WeekdayUm tipo enumerado que representa os dias da semana.
consoleEssa classe permite que o desenvolvedor grave no registro de execução e no Google Cloud Logging se o script estiver associado a um projeto padrão do Cloud.

Blob

Métodos

MétodoTipo de retornoBreve descrição
copyBlob()BlobRetorna uma cópia desse blob.
getAs(contentType)BlobRetorna os dados dentro deste objeto como um blob convertido para o tipo de conteúdo especificado.
getBytes()Byte[]Consegue os dados armazenados neste blob.
getContentType()StringRecebe o tipo de conteúdo dos bytes neste blob.
getDataAsString()StringRecebe os dados desse blob como uma string com codificação UTF-8.
getDataAsString(charset)StringConsegue os dados desse blob como uma string com a codificação especificada.
getName()StringExtrai o nome desse blob.
isGoogleType()BooleanRetorna se o blob é um arquivo do Google Workspace (Planilhas, Documentos etc.).
setBytes(data)BlobDefine os dados armazenados neste blob.
setContentType(contentType)BlobDefine o tipo de conteúdo dos bytes neste blob.
setContentTypeFromExtension()BlobDefine o tipo de conteúdo dos bytes neste blob com base na extensão do arquivo.
setDataFromString(string)BlobDefine os dados desse blob de uma string com codificação UTF-8.
setDataFromString(string, charset)BlobDefine os dados desse blob de uma string com a codificação especificada.
setName(name)BlobDefine o nome do blob.

BlobSource

Métodos

MétodoTipo de retornoBreve descrição
getAs(contentType)BlobRetorna os dados dentro deste objeto como um blob convertido para o tipo de conteúdo especificado.
getBlob()BlobRetorne os dados dentro deste objeto como um blob.

Browser

Propriedades

PropriedadeTipoDescrição
ButtonsButtonSet

Métodos

MétodoTipo de retornoBreve descrição
inputBox(prompt)StringMostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(prompt, buttons)StringMostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(title, prompt, buttons)StringMostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
msgBox(prompt)StringMostra uma caixa de diálogo com a mensagem e um botão "OK" no navegador do usuário.
msgBox(prompt, buttons)StringMostra uma caixa de diálogo com a mensagem e os botões especificados no navegador do usuário.
msgBox(title, prompt, buttons)StringMostra uma caixa de diálogo com o título, a mensagem e os botões especificados no navegador do usuário.

Button

Propriedades

PropriedadeTipoDescrição
CLOSEEnumO botão de fechar padrão exibido na barra de título de cada caixa de diálogo.
OKEnumUm botão "OK", indicando que uma operação precisa ser realizada.
CANCELEnumUm botão "Cancelar", indicando que uma operação não deve ser realizada.
YESEnumUm botão "Sim", indicando uma resposta positiva a uma pergunta.
NOEnumUm botão "Não", indicando uma resposta negativa a uma pergunta.

ButtonSet

Propriedades

PropriedadeTipoDescrição
OKEnumUm único botão "OK", indicando uma mensagem informativa que só pode ser dispensada.
OK_CANCELEnumUm botão "OK" e um botão "Cancelar", permitindo que o usuário prossiga ou interrompa uma operação.
YES_NOEnumUm botão "Sim" e um botão "Não", permitindo que o usuário responda a uma pergunta do tipo sim/não.
YES_NO_CANCELEnumUm botão "Sim", um botão "Não" e um botão "Cancelar", permitindo que o usuário responda a uma pergunta sim/não ou interrompa uma operação.

ColorType

Propriedades

PropriedadeTipoDescrição
UNSUPPORTEDEnumUm tipo de cor que não é aceito.
RGBEnumUma cor definida por canais de cor vermelho, verde e azul.
THEMEEnumUma cor que se refere a uma entrada no esquema de cores do tema.

Logger

Métodos

MétodoTipo de retornoBreve descrição
clear()voidLimpa o registro.
getLog()StringRetorna uma lista completa de mensagens no registro atual.
log(data)LoggerGrava os dados no registro.
log(format, values)LoggerGrava uma string formatada no console de registro usando o formato e os valores fornecidos.

Métodos

MétodoTipo de retornoBreve descrição
addItem(caption, functionName)MenuAdiciona um item ao menu.
addSeparator()MenuAdiciona um separador visual ao menu.
addSubMenu(menu)MenuAdiciona um submenu ao menu.
addToUi()voidInsere o menu na instância da interface do usuário do editor.

MimeType

Propriedades

PropriedadeTipoDescrição
GOOGLE_APPS_SCRIPTEnumRepresentação do tipo MIME para um projeto do Google Apps Script.
GOOGLE_DRAWINGSEnumRepresentação do tipo MIME de um arquivo do Google Desenhos.
GOOGLE_DOCSEnumRepresentação do tipo MIME de um arquivo do Documentos Google.
GOOGLE_FORMSEnumRepresentação do tipo MIME de um arquivo do Google Forms.
GOOGLE_SHEETSEnumRepresentação do tipo MIME de um arquivo das Planilhas Google.
GOOGLE_SITESEnumRepresentação do tipo MIME de um arquivo do Google Sites.
GOOGLE_SLIDESEnumRepresentação do tipo MIME de um arquivo do Apresentações Google.
FOLDEREnumRepresentação do tipo MIME de uma pasta do Google Drive.
SHORTCUTEnumRepresentação do tipo MIME de um atalho do Google Drive.
BMPEnumRepresentação do tipo MIME de um arquivo de imagem BMP (normalmente .bmp).
GIFEnumRepresentação do tipo MIME de um arquivo de imagem GIF (normalmente .gif).
JPEGEnumRepresentação do tipo MIME de um arquivo de imagem JPEG (normalmente .jpg).
PNGEnumRepresentação do tipo MIME de um arquivo de imagem PNG (normalmente .png).
SVGEnumRepresentação do tipo MIME de um arquivo de imagem SVG (normalmente .svg).
PDFEnumRepresentação do tipo MIME de um arquivo PDF (geralmente .pdf).
CSSEnumRepresentação do tipo MIME de um arquivo de texto CSS (normalmente .css).
CSVEnumRepresentação do tipo MIME de um arquivo de texto CSV (geralmente .csv).
HTMLEnumRepresentação do tipo MIME de um arquivo de texto HTML (normalmente .html).
JAVASCRIPTEnumRepresentação do tipo MIME de um arquivo de texto JavaScript (normalmente .js).
PLAIN_TEXTEnumRepresentação do tipo MIME de um arquivo de texto simples (normalmente .txt).
RTFEnumRepresentação do tipo MIME de um arquivo de texto enriquecido (normalmente .rtf).
OPENDOCUMENT_GRAPHICSEnumRepresentação do tipo MIME de um arquivo de gráficos OpenDocument (normalmente .odg).
OPENDOCUMENT_PRESENTATIONEnumRepresentação do tipo MIME de um arquivo de apresentação do OpenDocument (normalmente .odp).
OPENDOCUMENT_SPREADSHEETEnumRepresentação do tipo MIME de um arquivo de planilha OpenDocument (normalmente .ods).
OPENDOCUMENT_TEXTEnumRepresentação do tipo MIME de um arquivo de processamento de texto do OpenDocument (normalmente .odt).
MICROSOFT_EXCELEnumRepresentação do tipo MIME de um arquivo de planilha do Microsoft Excel (normalmente .xlsx).
MICROSOFT_EXCEL_LEGACYEnumRepresentação do tipo MIME de um arquivo legado do Microsoft Excel (normalmente .xls).
MICROSOFT_POWERPOINTEnumRepresentação do tipo MIME de um arquivo de apresentação do Microsoft PowerPoint (normalmente .pptx).
MICROSOFT_POWERPOINT_LEGACYEnumRepresentação do tipo MIME de um arquivo legado do Microsoft PowerPoint (normalmente .ppt).
MICROSOFT_WORDEnumRepresentação do tipo MIME de um arquivo de documento do Microsoft Word (normalmente .docx).
MICROSOFT_WORD_LEGACYEnumRepresentação do tipo MIME de um arquivo legado do Microsoft Word (normalmente .doc).
ZIPEnumRepresentação do tipo MIME de um arquivo ZIP (normalmente .zip).

Month

Propriedades

PropriedadeTipoDescrição
JANUARYEnumJaneiro (mês 1).
FEBRUARYEnumFevereiro (mês 2).
MARCHEnumMarço (mês 3).
APRILEnumAbril (mês 4).
MAYEnumMaio (5º mês).
JUNEEnumJunho (mês 6).
JULYEnumJulho (mês 7).
AUGUSTEnumAgosto (mês 8).
SEPTEMBEREnumSetembro (9º mês).
OCTOBEREnumOutubro (mês 10).
NOVEMBEREnumNovembro (mês 11).
DECEMBEREnumDezembro (mês 12).

PromptResponse

Métodos

MétodoTipo de retornoBreve descrição
getResponseText()StringRecebe o texto que o usuário digitou no campo de entrada da caixa de diálogo.
getSelectedButton()ButtonRecebe o botão em que o usuário clicou para dispensar a caixa de diálogo.

RgbColor

Métodos

MétodoTipo de retornoBreve descrição
asHexString()StringRetorna a cor como uma string hexadecimal de 7 caracteres no estilo CSS (#rrggbb) ou uma string hexadecimal de 9 caracteres (#aarrggbb).
getBlue()IntegerO canal azul dessa cor, como um número de 0 a 255.
getColorType()ColorTypeReceba o tipo dessa cor.
getGreen()IntegerO canal verde dessa cor, como um número de 0 a 255.
getRed()IntegerO canal vermelho dessa cor, como um número de 0 a 255.

Session

Métodos

MétodoTipo de retornoBreve descrição
getActiveUser()UserRecebe informações sobre o usuário atual.
getActiveUserLocale()StringExtrai a configuração de idioma do usuário atual como uma string, por exemplo, en para inglês.
getEffectiveUser()UserRecebe informações sobre o usuário com autoridade para executar o script.
getScriptTimeZone()StringRecebe o fuso horário do script.
getTemporaryActiveUserKey()StringRecebe uma chave temporária exclusiva para o usuário ativo, mas que não revela a identidade dele.

Ui

Propriedades

PropriedadeTipoDescrição
ButtonButtonUm tipo enumerado que representa botões de diálogo localizados e predeterminados retornados por um alert ou PromptResponse.getSelectedButton() para indicar em qual botão em uma caixa de diálogo o usuário clicou.
ButtonSetButtonSetUm tipo enumerado que representa conjuntos localizados e predefinidos de um ou mais botões de caixa de diálogo que podem ser adicionados a um alerta ou a um prompt.

Métodos

MétodoTipo de retornoBreve descrição
alert(prompt)ButtonAbre uma caixa de diálogo no editor do usuário com a mensagem e um botão "OK".
alert(prompt, buttons)ButtonAbre uma caixa de diálogo no editor do usuário com a mensagem e o conjunto de botões fornecidos.
alert(title, prompt, buttons)ButtonAbre uma caixa de diálogo no editor do usuário com o título, a mensagem e o conjunto de botões especificados.
createAddonMenu()MenuCria um builder que pode ser usado para inserir um submenu no menu "Extensões" do editor.
createMenu(caption)MenuCria um builder que pode ser usado para adicionar um menu à interface do usuário do editor.
prompt(prompt)PromptResponseAbre uma caixa de diálogo de entrada no editor do usuário com a mensagem especificada e um botão "OK".
prompt(prompt, buttons)PromptResponseAbre uma caixa de diálogo de entrada no editor do usuário com a mensagem e o conjunto de botões fornecidos.
prompt(title, prompt, buttons)PromptResponseAbre uma caixa de diálogo de entrada no editor do usuário com o título, a mensagem e o conjunto de botões fornecidos.
showModalDialog(userInterface, title)voidAbre uma caixa de diálogo modal no editor do usuário com conteúdo personalizado do lado do cliente.
showModelessDialog(userInterface, title)voidAbre uma caixa de diálogo sem modo no editor do usuário com conteúdo personalizado do lado do cliente.
showSidebar(userInterface)voidAbre uma barra lateral no editor do usuário com conteúdo personalizado do lado do cliente.

User

Métodos

MétodoTipo de retornoBreve descrição
getEmail()StringRetorna o endereço de e-mail do usuário, se disponível.

Weekday

Propriedades

PropriedadeTipoDescrição
SUNDAYEnumDomingo.
MONDAYEnumSegunda-feira.
TUESDAYEnumTerça-feira.
WEDNESDAYEnumQuarta-feira.
THURSDAYEnumquinta-feira.
FRIDAYEnumSexta-feira.
SATURDAYEnumsábado.

console

Métodos

MétodoTipo de retornoBreve descrição
error()voidEnvia uma mensagem em branco de nível de ERRO para o Stackdriver Logging.
error(formatOrObject, values)voidEnvia uma mensagem de nível ERROR para o Stackdriver Logging.
info()voidEnvia uma mensagem de nível INFO em branco para o Stackdriver Logging.
info(formatOrObject, values)voidEnvia uma mensagem de nível INFO para o Stackdriver Logging.
log()voidEnvia uma mensagem em branco no nível DEBUG para o Stackdriver Logging.
log(formatOrObject, values)voidGera uma mensagem de nível DEBUG para o Stackdriver Logging.
time(label)voidInicia um cronômetro que pode ser usado para acompanhar o tempo de uma operação.
timeEnd(label)voidParar um timer que foi iniciado anteriormente chamando console.time().
warn()voidEnvia uma mensagem em branco de nível de ALERTA para o Stackdriver Logging.
warn(formatOrObject, values)voidEnvia uma mensagem de nível WARNING para o Stackdriver Logging.