Base Service

Base

Esse serviço dá 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 do Google Planilhas.
ButtonUma enumeração que representa botões de caixa de diálogo predeterminados e localizados retornados por um alert ou PromptResponse.getSelectedButton() para indicar em qual botão de uma caixa de diálogo o usuário clicou.
ButtonSetUma enumeração que representa conjuntos predeterminados e localizados de um ou mais botões de caixa de diálogo que podem ser adicionados a um alert ou um prompt.
ColorTypeOs tipos 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 enum que representa os meses do ano.
PromptResponseUma resposta a uma caixa de diálogo prompt exibida no ambiente de interface do usuário de um app do Google.
RgbColorUma cor definida por canais de cores vermelha, verde e azul.
SessionA classe "Session" fornece acesso a 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 para um app do Google que permite ao script adicionar recursos como menus, caixas de diálogo e barras laterais.
UserRepresentação de um usuário, adequada para programação.
WeekdayUma enumeração 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 deste blob.
getAs(contentType)BlobRetorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
getBytes()Byte[]Recebe os dados armazenados neste blob.
getContentType()StringRecebe o tipo de conteúdo dos bytes neste blob.
getDataAsString()StringRecebe os dados deste blob como uma string com codificação UTF-8.
getDataAsString(charset)StringRecebe os dados deste blob como uma string com a codificação especificada.
getName()StringRecebe o nome deste blob.
isGoogleType()BooleanRetorna se este 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 com uma string codificada em UTF-8.
setDataFromString(string, charset)BlobDefine os dados deste blob de uma string com a codificação especificada.
setName(name)BlobDefine o nome deste blob.

BlobSource

Métodos

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

Browser

Propriedades

PropriedadeTipoDescrição
ButtonsButtonSet

Métodos

MétodoTipo de retornoBreve descrição
inputBox(prompt)String|nullAbre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(prompt, buttons)String|nullAbre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(title, prompt, buttons)String|nullAbre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
msgBox(prompt)String|nullMostra uma caixa de diálogo com a mensagem especificada e um botão "OK" no navegador do usuário.
msgBox(prompt, buttons)String|nullMostra uma caixa de diálogo com a mensagem e os botões especificados no navegador do usuário.
msgBox(title, prompt, buttons)String|nullAbre 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 todas as caixas de diálogo.
OKEnumUm botão "OK", indicando que uma operação deve continuar.
CANCELEnumUm botão "Cancelar", indicando que uma operação não deve continuar.
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 continue 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 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 de sim/não ou interrompa uma operação.

ColorType

Propriedades

PropriedadeTipoDescrição
UNSUPPORTEDEnumUm tipo de cor que não é compatível.
RGBEnumUma cor definida por canais de cores vermelha, 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)LoggerEscreve uma string formatada no console de geração de registros 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 Google Docs.
GOOGLE_FORMSEnumRepresentação do tipo MIME de um arquivo do Google Forms.
GOOGLE_SHEETSEnumRepresentação do tipo MIME de um arquivo do Google Sheets.
GOOGLE_SITESEnumRepresentação do tipo MIME de um arquivo do Google Sites.
GOOGLE_SLIDESEnumRepresentação do tipo MIME de um arquivo do Google Slides.
FOLDEREnumRepresentação do tipo MIME de uma pasta do Google Drive.
SHORTCUTEnumRepresentação do tipo MIME para um atalho do Google Drive.
BMPEnumRepresentação do tipo MIME de um arquivo de imagem BMP (normalmente .bmp).
GIFEnumRepresentação do tipo MIME para 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 (normalmente .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 (normalmente .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 para um arquivo de texto simples (normalmente .txt).
RTFEnumRepresentação do tipo MIME de um arquivo de texto formatado (normalmente .rtf).
OPENDOCUMENT_GRAPHICSEnumRepresentação do tipo MIME para um arquivo de gráficos OpenDocument (normalmente .odg).
OPENDOCUMENT_PRESENTATIONEnumRepresentação do tipo MIME para um arquivo de apresentação OpenDocument (normalmente .odp).
OPENDOCUMENT_SPREADSHEETEnumRepresentação do tipo MIME de um arquivo de planilha OpenDocument (normalmente .ods).
OPENDOCUMENT_TEXTEnumRepresentação do tipo MIME para um arquivo de processamento de texto 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 (mês 5).
JUNEEnumJunho (mês 6).
JULYEnumJulho (mês 7).
AUGUSTEnumAgosto (mês 8).
SEPTEMBEREnumSetembro (mês 9).
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 inseriu 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 sete caracteres no estilo CSS (#rrggbb) ou uma string hexadecimal de nove caracteres (#aarrggbb).
getBlue()IntegerO canal azul dessa cor, como um número de 0 a 255.
getColorType()ColorTypeRecebe 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()StringRecebe 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 em nome de quem o script está sendo executado.
getScriptTimeZone()StringRecebe o fuso horário do script.
getTemporaryActiveUserKey()StringRecebe uma chave temporária exclusiva para o usuário ativo, mas não revela a identidade dele.

Ui

Propriedades

PropriedadeTipoDescrição
ButtonButtonUma enumeração que representa botões de caixa de diálogo predeterminados e localizados retornados por um alerta ou PromptResponse.getSelectedButton() para indicar em qual botão de uma caixa de diálogo o usuário clicou.
ButtonSetButtonSetUma enumeração que representa conjuntos predeterminados e localizados de um ou mais botões de caixa de diálogo que podem ser adicionados a um alerta ou um comando.

Métodos

MétodoTipo de retornoBreve descrição
alert(prompt)ButtonAbre uma caixa de diálogo no editor do usuário com a mensagem especificada 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 especificados.
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 especificados.
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 especificados.
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 modalidade 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()StringRecebe 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()voidGera uma mensagem em branco no nível ERROR para o Stackdriver Logging.
error(formatOrObject, values)voidGera uma mensagem de nível ERROR para o Stackdriver Logging.
info()voidGera uma mensagem em branco no nível INFO para o Stackdriver Logging.
info(formatOrObject, values)voidGera uma mensagem no nível INFO para o Stackdriver Logging.
log()voidGera 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 timer que pode ser usado para rastrear quanto tempo leva uma operação.
timeEnd(label)voidInterrompe um timer iniciado anteriormente chamando console.time().
warn()voidGera uma mensagem em branco no nível WARNING para o Stackdriver Logging.
warn(formatOrObject, values)voidGera uma mensagem de nível WARNING no Stackdriver Logging.