Class Utilities

Utilitários

Este serviço fornece utilitários para codificação/decodificação de strings, formatação de datas, manipulação de JSON, e outras tarefas diversas.

Propriedades

Propriedade	Tipo	Descrição
Charset	Charset
DigestAlgorithm	DigestAlgorithm
MacAlgorithm	MacAlgorithm
RsaAlgorithm	RsaAlgorithm

Métodos

Método	Tipo de retorno	Breve descrição
base64Decode(encoded)	Byte[]	Decodifica uma string codificada em base64 em uma matriz de bytes UTF-8.
base64Decode(encoded, charset)	Byte[]	Decodifica uma string codificada em base64 em uma matriz de bytes em um conjunto de caracteres específico.
base64DecodeWebSafe(encoded)	Byte[]	Decodifica uma string codificada com base 64 segura para a Web em uma matriz de bytes UTF-8.
base64DecodeWebSafe(encoded, charset)	Byte[]	Decodifica uma string codificada com base 64 segura para a Web em uma matriz de bytes em um conjunto de caracteres específico.
base64Encode(data)	String	Gera uma string codificada em base64 a partir da matriz de bytes fornecida.
base64Encode(data)	String	Gera uma string codificada em base64 a partir da string fornecida.
base64Encode(data, charset)	String	Gera uma string codificada em base64 a partir da string especificada em um conjunto de caracteres específico.
base64EncodeWebSafe(data)	String	Gera uma string codificada segura para a Web em base64 a partir da matriz de bytes fornecida.
base64EncodeWebSafe(data)	String	Gera uma string codificada segura para a Web em base64 a partir da string fornecida.
base64EncodeWebSafe(data, charset)	String	Gera uma string codificada com base 64 segura para a Web a partir da string fornecida em um conjunto de caracteres específico.
computeDigest(algorithm, value)	Byte[]	Calcula um resumo usando o algoritmo especificado no valor de Byte[] especificado.
computeDigest(algorithm, value)	Byte[]	Calcula um resumo usando o algoritmo especificado no valor de String especificado.
computeDigest(algorithm, value, charset)	Byte[]	Calcula um resumo usando o algoritmo especificado no valor de String especificado com o determinado conjunto de caracteres.
computeHmacSha256Signature(value, key)	Byte[]	Assina o valor fornecido usando HMAC-SHA256 com a chave fornecida.
computeHmacSha256Signature(value, key)	Byte[]	Assina o valor fornecido usando HMAC-SHA256 com a chave fornecida.
computeHmacSha256Signature(value, key, charset)	Byte[]	Assina o valor fornecido usando HMAC-SHA256 com a chave e o conjunto de caracteres fornecidos.
computeHmacSignature(algorithm, value, key)	Byte[]	Calcula um código de autenticação de mensagem usando o algoritmo especificado na chave especificada e .
computeHmacSignature(algorithm, value, key)	Byte[]	Calcula um código de autenticação de mensagem usando o algoritmo especificado na chave especificada e .
computeHmacSignature(algorithm, value, key, charset)	Byte[]	Calcula um código de autenticação de mensagem usando o algoritmo especificado na chave especificada e .
computeRsaSha1Signature(value, key)	Byte[]	Assina o valor fornecido usando RSA-SHA1 com a chave fornecida.
computeRsaSha1Signature(value, key, charset)	Byte[]	Assina o valor fornecido usando RSA-SHA1 com a chave e o conjunto de caracteres fornecidos.
computeRsaSha256Signature(value, key)	Byte[]	Assina o valor fornecido usando RSA-SHA256 com a chave fornecida.
computeRsaSha256Signature(value, key, charset)	Byte[]	Assina o valor fornecido usando RSA-SHA256 com a chave fornecida.
computeRsaSignature(algorithm, value, key)	Byte[]	Assina o valor fornecido usando o algoritmo RSA especificado com a chave fornecida.
computeRsaSignature(algorithm, value, key, charset)	Byte[]	Assina o valor fornecido usando o algoritmo RSA especificado com a chave e o conjunto de caracteres fornecidos.
formatDate(date, timeZone, format)	String	Formata a data de acordo com a especificação descrita na classe SimpleDateFormat do Java SE.
formatString(template, args)	String	Executa a formatação de string semelhante a sprintf usando strings de formato no estilo "%".
getUuid()	String	Receba um UUID como uma string (equivalente ao uso do método java.util.UUID.randomUUID()).
gzip(blob)	Blob	gzip compacta os dados Blob fornecidos e os retorna em um novo objeto Blob.
gzip(blob, name)	Blob	gzip compacta os dados Blob fornecidos e os retorna em um novo objeto Blob.
newBlob(data)	Blob	Cria um novo objeto Blob a partir de uma matriz de bytes.
newBlob(data, contentType)	Blob	Cria um novo objeto Blob a partir de uma matriz de bytes e tipo de conteúdo.
newBlob(data, contentType, name)	Blob	Cria um novo objeto Blob a partir de uma matriz de bytes, tipo de conteúdo e nome.
newBlob(data)	Blob	Cria um novo objeto Blob a partir de uma string.
newBlob(data, contentType)	Blob	Cria um novo objeto Blob a partir de uma string e um tipo de conteúdo.
newBlob(data, contentType, name)	Blob	Cria um novo objeto Blob a partir de uma string, um tipo de conteúdo e um nome.
parseCsv(csv)	String[][]	Retorna uma representação de matriz 2D tabular de uma string CSV.
parseCsv(csv, delimiter)	String[][]	Retorna uma representação de matriz 2D tabular de uma string CSV usando um delimitador personalizado.
parseDate(date, timeZone, format)	Date	Analisa a data da string fornecida de acordo com a especificação descrita no Java Standard Classe SimpleDateFormat da edição.
sleep(milliseconds)	void	Suspende por um número especificado de milissegundos.
ungzip(blob)	Blob	Descompacta um objeto Blob e retorna um Blob contendo o dados.
unzip(blob)	Blob[]	Utiliza um Blob que representa um arquivo zip e retorna seus arquivos de componente.
zip(blobs)	Blob	Cria um novo objeto Blob que é um arquivo zip contendo os dados dos Blobs passados.
zip(blobs, name)	Blob	Cria um novo objeto Blob que é um arquivo zip contendo os dados dos Blobs passados.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
jsonParse(jsonString)	Object	Retorne um objeto correspondente à string JSON transmitida.
jsonStringify(obj)	String	Retorne uma string JSON do objeto transmitido.

Documentação detalhada

base64Decode(encoded)

Decodifica uma string codificada em base64 em uma matriz de bytes UTF-8.

// This is the base64 encoded form of "Google グループ"
var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw==";

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
var decoded = Utilities.base64Decode(base64data);
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parâmetros

Nome	Tipo	Descrição
encoded	String	Uma matriz de bytes de dados a serem decodificados.

Retornar

Byte[]: os dados brutos representados pelo argumento codificado em base64 como uma matriz de bytes.

---

base64Decode(encoded, charset)

Decodifica uma string codificada em base64 em uma matriz de bytes em um conjunto de caracteres específico.

// This is the base64 encoded form of "Google グループ"
var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw==";

var decoded = Utilities.base64Decode(base64data, Utilities.Charset.UTF_8);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parâmetros

Nome	Tipo	Descrição
encoded	String	A string de dados a ser decodificada.
charset	Charset	Um Charset especificando o conjunto de caracteres da entrada.

Retornar

Byte[]: os dados brutos representados pelo argumento codificado em base64 como uma matriz de bytes.

---

base64DecodeWebSafe(encoded)

Decodifica uma string codificada com base 64 segura para a Web em uma matriz de bytes UTF-8.

// This is the base64 web-safe encoded form of "Google グループ"
var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw==";

var decoded = Utilities.base64DecodeWebSafe(base64data);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parâmetros

Nome	Tipo	Descrição
encoded	String	Uma matriz de bytes de dados seguros para a Web para decodificar.

Retornar

Byte[]: os dados brutos representados pelo argumento codificado com segurança para a Web em base64 como uma matriz de bytes.

---

base64DecodeWebSafe(encoded, charset)

Decodifica uma string codificada com base 64 segura para a Web em uma matriz de bytes em um conjunto de caracteres específico.

// This is the base64 web-safe encoded form of "Google グループ"
var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw==";

var decoded = Utilities.base64DecodeWebSafe(base64data, Utilities.Charset.UTF_8);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parâmetros

Nome	Tipo	Descrição
encoded	String	A string de dados seguros para a Web a ser decodificada.
charset	Charset	Um Charset especificando o conjunto de caracteres da entrada.

Retornar

Byte[]: os dados brutos representados pelo argumento codificado com segurança para a Web em base64 como uma matriz de bytes.

---

base64Encode(data)

Gera uma string codificada em base64 a partir da matriz de bytes fornecida. A base 64 é uma codificação aceito por diversas ferramentas que não aceitam dados binários. A base 64 costuma ser usada protocolos da Internet, como e-mail, HTTP ou em documentos XML.

// Instantiates a blob here for clarity
var blob = Utilities.newBlob("A string here");

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var encoded = Utilities.base64Encode(blob.getBytes());
Logger.log(encoded);

Parâmetros

Nome	Tipo	Descrição
data	Byte[]	Um byte[] de dados para codificar.

Retornar

String: a representação codificada em base64 dos dados transmitidos.

---

base64Encode(data)

Gera uma string codificada em base64 a partir da string fornecida. O Base64 é uma codificação de codificação comum aceita por uma variedade de ferramentas que não aceitam dados binários. A base 64 é usada com frequência na Internet protocolos como e-mail, HTTP ou em documentos XML.

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var encoded = Utilities.base64Encode("A string here");
Logger.log(encoded);

Parâmetros

Nome	Tipo	Descrição
data	String	A string a ser codificada.

Retornar

String: a representação codificada em base64 da string de entrada.

---

base64Encode(data, charset)

Gera uma string codificada em base64 a partir da string especificada em um conjunto de caracteres específico. Um conjunto de caracteres é uma forma de codificar caracteres para que sejam codificados. Isso geralmente é feito em uma formato binário, que geralmente pode ser incompatível com determinados protocolos de transmissão de dados. Para tornam os dados compatíveis, eles geralmente são codificados em base64, que é uma linguagem aceito por diversas ferramentas que não aceitam dados binários. A base 64 costuma ser usada protocolos da Internet, como e-mail, HTTP ou em documentos XML.

// "Google Groups" in Katakana (Japanese)
var input = "Google グループ";

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
var encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

Parâmetros

Nome	Tipo	Descrição
data	String	A string de dados a ser codificada.
charset	Charset	Um Charset especificando o conjunto de caracteres da entrada.

Retornar

String: a representação codificada em base64 da string de entrada com o Charset especificado.

---

base64EncodeWebSafe(data)

Gera uma string codificada segura para a Web em base64 a partir da matriz de bytes fornecida. A base 64 é muito usada codificação de dados aceita por diversas ferramentas que não aceitam dados binários. Segurança para a Web de base 64 é comumente usados em protocolos da Internet, como e-mail, HTTP ou em documentos XML.

// Instantiates a blob here for clarity
var blob = Utilities.newBlob("A string here");

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var encoded = Utilities.base64EncodeWebSafe(blob.getBytes());
Logger.log(encoded);

Parâmetros

Nome	Tipo	Descrição
data	Byte[]	Uma matriz de bytes de dados para codificar.

Retornar

String: a representação codificada segura para a Web em base64 dos dados transmitidos.

---

base64EncodeWebSafe(data)

Gera uma string codificada segura para a Web em base64 a partir da string fornecida. A base 64 é uma codificação aceito por diversas ferramentas que não aceitam dados binários. O padrão 64 seguro para a Web costuma ser usados em protocolos da Internet, como e-mail, HTTP ou em documentos XML.

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var encoded = Utilities.base64EncodeWebSafe("A string here");
Logger.log(encoded);

Parâmetros

Nome	Tipo	Descrição
data	String	A string a ser codificada.

Retornar

String: a representação codificada segura para a Web de base64 da string de entrada.

---

base64EncodeWebSafe(data, charset)

Gera uma string codificada com base 64 segura para a Web a partir da string fornecida em um conjunto de caracteres específico. Um conjunto de caracteres é uma forma de codificar caracteres para que possam ser codificados. Elas normalmente são é feito em formato binário, o que geralmente é incompatível com certas transmissões de dados, protocolos. Para tornar os dados compatíveis, eles geralmente são codificados em base 64, que é uma codificação comum aceita por diversas ferramentas que não aceitam dados binários. Segurança para a Web de base 64 é comumente usado em protocolos da Internet, como e-mail, HTTP ou em documentos XML.

// "Google Groups" in Katakana (Japanese)
var input = "Google グループ";

// Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log
var encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

Parâmetros

Nome	Tipo	Descrição
data	String	A string de dados a ser codificada.
charset	Charset	Um Charset especificando o conjunto de caracteres da entrada.

Retornar

String: a representação codificada segura para a Web de base64 da string de entrada com o Charset especificado.

---

computeDigest(algorithm, value)

Calcula um resumo usando o algoritmo especificado no valor de Byte[] especificado.

var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash")
var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input);
Logger.log(digest);

Parâmetros

Nome	Tipo	Descrição
algorithm	DigestAlgorithm	Um DigestAlgorithm para usar.
value	Byte[]	Um valor de string de entrada para calcular um resumo.

Retornar

Byte[]: um byte[] que representa o resumo de saída.

---

computeDigest(algorithm, value)

Calcula um resumo usando o algoritmo especificado no valor de String especificado.

var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, "input to hash");
Logger.log(digest);

Parâmetros

Nome	Tipo	Descrição
algorithm	DigestAlgorithm	Um DigestAlgorithm para usar.
value	String	Um valor de string de entrada para calcular um resumo.

Retornar

Byte[]: um byte[] que representa o resumo de saída.

---

computeDigest(algorithm, value, charset)

Calcula um resumo usando o algoritmo especificado no valor de String especificado com o determinado conjunto de caracteres.

var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5,
                                     "input to hash",
                                     Utilities.Charset.US_ASCII);
Logger.log(digest);

Parâmetros

Nome	Tipo	Descrição
algorithm	DigestAlgorithm	Um DigestAlgorithm para usar.
value	String	Um valor de string de entrada para calcular um resumo.
charset	Charset	Um Charset que representa o conjunto de caracteres de entrada.

Retornar

Byte[]: um byte[] que representa o resumo de saída.

---

computeHmacSha256Signature(value, key)

Assina o valor fornecido usando HMAC-SHA256 com a chave fornecida.

// This writes an array of bytes to the log.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash")
var key = Utilities.base64Decode("a2V5"); // == base64encode("key")
var signature = Utilities.computeHmacSha256Signature(input, key);
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
value	Byte[]	O valor de entrada para gerar um hash.
key	Byte[]	Uma chave para usar para gerar o hash.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeHmacSha256Signature(value, key)

Assina o valor fornecido usando HMAC-SHA256 com a chave fornecida.

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSha256Signature("this is my input",
                                                      "my key - use a stronger one");
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave para usar para gerar o hash.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeHmacSha256Signature(value, key, charset)

Assina o valor fornecido usando HMAC-SHA256 com a chave e o conjunto de caracteres fornecidos.

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSha256Signature("this is my input",
                                                     "my key - use a stronger one",
                                                     Utilities.Charset.US_ASCII);
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave para usar para gerar o hash.
charset	Charset	Um Charset que representa o conjunto de caracteres de entrada.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeHmacSignature(algorithm, value, key)

Calcula um código de autenticação de mensagem usando o algoritmo especificado na chave especificada e .

// This writes an array of bytes to the log.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash")
var key = Utilities.base64Decode("a2V5"); // == base64encode("key")
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5, input, key);
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
algorithm	MacAlgorithm	Um algoritmo MacAlgorithm a ser usado para gerar hash do valor de entrada.
value	Byte[]	O valor de entrada para gerar um hash.
key	Byte[]	Uma chave para usar para gerar o hash.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeHmacSignature(algorithm, value, key)

Calcula um código de autenticação de mensagem usando o algoritmo especificado na chave especificada e .

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5,
                                               "input to hash",
                                               "key");
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
algorithm	MacAlgorithm	Um algoritmo MacAlgorithm a ser usado para gerar hash do valor de entrada.
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave para usar para gerar o hash.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeHmacSignature(algorithm, value, key, charset)

Calcula um código de autenticação de mensagem usando o algoritmo especificado na chave especificada e .

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5,
                                               "input to hash",
                                               "key",
                                               Utilities.Charset.US_ASCII);
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
algorithm	MacAlgorithm	Um algoritmo MacAlgorithm a ser usado para gerar hash do valor de entrada.
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave para usar para gerar o hash.
charset	Charset	Uma Charset que representa o conjunto de caracteres de entrada.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeRsaSha1Signature(value, key)

Assina o valor fornecido usando RSA-SHA1 com a chave fornecida.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave no formato PEM a ser usada para gerar a assinatura.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeRsaSha1Signature(value, key, charset)

Assina o valor fornecido usando RSA-SHA1 com a chave e o conjunto de caracteres fornecidos.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n"
    Utilities.Charset.US_ASCII);
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave no formato PEM a ser usada para gerar a assinatura.
charset	Charset	Um Charset que representa o conjunto de caracteres de entrada.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeRsaSha256Signature(value, key)

Assina o valor fornecido usando RSA-SHA256 com a chave fornecida.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave no formato PEM a ser usada para gerar a assinatura.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeRsaSha256Signature(value, key, charset)

Assina o valor fornecido usando RSA-SHA256 com a chave fornecida.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave no formato PEM a ser usada para gerar a assinatura.
charset	Charset	Uma Charset que representa o conjunto de caracteres de entrada.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeRsaSignature(algorithm, value, key)

Assina o valor fornecido usando o algoritmo RSA especificado com a chave fornecida.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
algorithm	RsaAlgorithm	Um algoritmo RsaAlgorithm a ser usado para gerar hash do valor de entrada.
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave no formato PEM a ser usada para gerar a assinatura.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

computeRsaSignature(algorithm, value, key, charset)

Assina o valor fornecido usando o algoritmo RSA especificado com a chave e o conjunto de caracteres fornecidos.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n",
    Utilities.Charset.US_ASCII);
Logger.log(signature);

Parâmetros

Nome	Tipo	Descrição
algorithm	RsaAlgorithm	Um algoritmo RsaAlgorithm a ser usado para gerar hash do valor de entrada.
value	String	O valor de entrada para gerar um hash.
key	String	Uma chave no formato PEM a ser usada para gerar a assinatura.
charset	Charset	Um Charset que representa o conjunto de caracteres de entrada.

Retornar

Byte[]: um byte[] que representa a assinatura de saída.

---

formatDate(date, timeZone, format)

Formata a data de acordo com a especificação descrita na classe SimpleDateFormat do Java SE. Não se esqueça visite a especificação em http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

// This formats the date as Greenwich Mean Time in the format
// year-month-dateThour-minute-second.
var formattedDate = Utilities.formatDate(new Date(), "GMT", "yyyy-MM-dd'T'HH:mm:ss'Z'");
Logger.log(formattedDate);

Parâmetros

Nome	Tipo	Descrição
date	Date	Um Date para formatar como uma string.
timeZone	String	O fuso horário de saída do resultado.
format	String	Um formato de acordo com a especificação SimpleDateFormat.

Retornar

String: a data de entrada como uma string formatada.

---

formatString(template, args)

Executa a formatação de string semelhante a sprintf usando strings de formato no estilo "%".

// " 123.456000"
Utilities.formatString('%11.6f', 123.456);

// "   abc"
Utilities.formatString('%6s', 'abc');

Parâmetros

Nome	Tipo	Descrição
template	String	A string de formato que controla o que é retornado.
args	Object...	Objetos para usar para preencher o valor de '%' os espaços reservados no modelo.

Retornar

String: a string formatada.

---

getUuid()

Receba um UUID como uma string (equivalente ao uso do método java.util.UUID.randomUUID()). Não há garantia de que esse identificador será exclusivo em todo o espaço e tempo. Por isso, não use em situações em que a exclusividade garantida é necessária.

//This assigns a UUID as a temporary ID for a data object you are creating in your script.
var myDataObject = {
   tempId: Utilities.getUuid();
};

Retornar

String: uma representação de string do UUID.

---

gzip(blob)

gzip compacta os dados Blob fornecidos e os retorna em um novo objeto Blob.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

// Create the compressed blob.
var gzipBlob = Utilities.gzip(textBlob);

Parâmetros

Nome	Tipo	Descrição
blob	BlobSource	Um objeto Blob para compactar usando gzip.

Retornar

Blob: um novo Blob contendo os dados compactados.

---

gzip(blob, name)

gzip compacta os dados Blob fornecidos e os retorna em um novo objeto Blob. Essa versão do método permite que um nome de arquivo seja especificado.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

// Create the compressed blob.
var gzipBlob = Utilities.gzip(textBlob, "text.gz");

Parâmetros

Nome	Tipo	Descrição
blob	BlobSource	Um objeto Blob para compactar usando gzip.
name	String	O nome do arquivo gzip a ser criado.

Retornar

Blob: uma nova Blob contendo os dados compactados.

---

newBlob(data)

Cria um novo objeto Blob a partir de uma matriz de bytes. Os blobs são usados em muitas APIs do Apps Script que usam dados binários como entrada.

// Creates a blob object from a byte array.
const data = [71, 79, 79, 71, 76, 69];
const blob = Utilities.newBlob(data);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

Parâmetros

Nome	Tipo	Descrição
data	Byte[]	Os bytes do blob.

Retornar

Blob: o blob recém-criado.

---

newBlob(data, contentType)

Cria um novo objeto Blob a partir de uma matriz de bytes e tipo de conteúdo. Os blobs são usados em muitos Apps Script. APIs que recebem dados binários como entrada.

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Creates a blob object from the byte array and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

Parâmetros

Nome	Tipo	Descrição
data	Byte[]	Os bytes do blob.
contentType	String	O tipo de conteúdo do blob: pode ser null.

Retornar

Blob: o blob recém-criado.

---

newBlob(data, contentType, name)

Cria um novo objeto Blob a partir de uma matriz de bytes, tipo de conteúdo e nome. Os blobs são usados em muitos apps APIs de script que recebem dados binários como entrada.

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Creates a blob object from the byte array, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data as a string to the console.
console.log('Blob data:', blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

Parâmetros

Nome	Tipo	Descrição
data	Byte[]	Os bytes do blob.
contentType	String	- O tipo de conteúdo do blob: pode ser null.
name	String	O nome do blob: pode ser null.

Retornar

Blob: o blob recém-criado.

---

newBlob(data)

Cria um novo objeto Blob a partir de uma string. Os blobs são usados em muitas APIs do Apps Script que usam dados binários como entrada.

// Declares a string for the blob.
const data = 'GOOGLE';

// Creates a blob object from a string.
const blob = Utilities.newBlob(data);

// Logs the blob data in byte array to the console.
console.log('Blob Data:', blob.getBytes());

Parâmetros

Nome	Tipo	Descrição
data	String	A string do blob, presumido como UTF-8.

Retornar

Blob: o blob recém-criado.

---

newBlob(data, contentType)

Cria um novo objeto Blob a partir de uma string e um tipo de conteúdo. Os blobs são usados em muitos Apps Script. APIs que recebem dados binários como entrada.

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of blob.
const contentType = 'application/json';

// Creates a blob object from the string and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

Parâmetros

Nome	Tipo	Descrição
data	String	A string do blob, presumido como UTF-8.
contentType	String	O tipo de conteúdo do blob: pode ser null.

Retornar

Blob: o blob recém-criado.

---

newBlob(data, contentType, name)

Cria um novo objeto Blob a partir de uma string, um tipo de conteúdo e um nome. Os blobs são usados em muitos apps APIs de script que recebem dados binários como entrada.

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Create a blob object from the string, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

Parâmetros

Nome	Tipo	Descrição
data	String	A string do blob, presumido como UTF-8.
contentType	String	O tipo de conteúdo do blob: pode ser null.
name	String	O nome do blob: pode ser null.

Retornar

Blob: o blob recém-criado.

---

parseCsv(csv)

Retorna uma representação de matriz 2D tabular de uma string CSV.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
var csvString = "a,b,c\nd,e,f";
var data = Utilities.parseCsv(csvString);

Parâmetros

Nome	Tipo	Descrição
csv	String	String com dados de uma ou várias linhas em valores separados por vírgulas (CSV) .

Retornar

String[][]: uma matriz bidimensional contendo os valores na string CSV.

---

parseCsv(csv, delimiter)

Retorna uma representação de matriz 2D tabular de uma string CSV usando um delimitador personalizado.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
var csvString = "a\tb\tc\nd\te\tf";
var data = Utilities.parseCsv(csvString, '\t');

Parâmetros

Nome	Tipo	Descrição
csv	String	String com dados de uma ou várias linhas em valores separados por vírgulas (CSV) .
delimiter	Char	Entre valores.

Retornar

String[][]: uma matriz bidimensional contendo os valores na string CSV.

---

parseDate(date, timeZone, format)

Analisa a data da string fornecida de acordo com a especificação descrita no Java Standard Classe SimpleDateFormat da edição. Para mais informações, consulte a classe SimpleDateFormat (link em inglês) do Java.

// This set of parameters parses the given string as a date in Greenwich Mean Time, formatted
// as year-month-dateThour-minute-second.
var date = Utilities.parseDate("1970-01-01 00:00:00", "GMT", "yyyy-MM-dd' 'HH:mm:ss");
Logger.log(date);

Parâmetros

Nome	Tipo	Descrição
date	String	Um valor de string para analisar como uma data.
timeZone	String	O fuso horário de saída.
format	String	É o formato de data de acordo com a especificação SimpleDateFormat.

Retornar

Date: a string de entrada como uma data.

---

sleep(milliseconds)

Suspende por um número especificado de milissegundos. Coloca o script em suspensão imediatamente durante o número especificado de milissegundos. O valor máximo permitido é 300.000 (ou 5 minutos).

// Creates a blob object from a string.
const data = 'GOOGLE';
const blob = Utilities.newBlob(data);

// Puts the script to sleep for 10,000 milliseconds (10 seconds).
Utilities.sleep(10000);

// Logs the blob data in byte array to the console.
console.log(blob.getBytes());

Parâmetros

Nome	Tipo	Descrição
milliseconds	Integer	O número de milissegundos para suspensão.

---

ungzip(blob)

Descompacta um objeto Blob e retorna um Blob contendo o dados.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

// Create the compressed blob.
var gzipBlob = Utilities.gzip(textBlob, "text.gz");

// Uncompress the data.
var uncompressedBlob = Utilities.ungzip(gzipBlob);

Parâmetros

Nome	Tipo	Descrição
blob	BlobSource	O Blob dos dados compactados.

Retornar

Blob: uma Blob que representa os dados descompactados.

---

unzip(blob)

Utiliza um Blob que representa um arquivo zip e retorna seus arquivos de componente.

var googleFavIconUrl = "https://www.google.com/favicon.ico";
var googleLogoUrl = "https://www.google.com/images/srpr/logo3w.png";

// Fetch the Google favicon.ico file and get the Blob data
var faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
var logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and logoBlob
var zip = Utilities.zip([faviconBlob, logoBlob], "google_images.zip");

// This now unzips the blobs
var files = Utilities.unzip(zip);

Parâmetros

Nome	Tipo	Descrição
blob	BlobSource	O blob do arquivo ZIP.

Retornar

Blob[]: um Blob[] que representa os blobs do componente, cada um nomeado com o caminho completo dentro do zip.

---

zip(blobs)

Cria um novo objeto Blob que é um arquivo zip contendo os dados dos Blobs passados.

var googleFavIconUrl = "https://www.google.com/favicon.ico";
var googleLogoUrl = "https://www.google.com/images/srpr/logo3w.png";

// Fetch the Google favicon.ico file and get the Blob data
var faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
var logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and logoBlob
var zip = Utilities.zip([faviconBlob, logoBlob]);

Parâmetros

Nome	Tipo	Descrição
blobs	BlobSource[]	Uma matriz de blobs a serem compactados.

Retornar

Blob: um novo blob contendo as entradas como um arquivo.

---

zip(blobs, name)

Cria um novo objeto Blob que é um arquivo zip contendo os dados dos Blobs passados. Isso do método permite que um nome de arquivo seja especificado.

var googleFavIconUrl = "https://www.google.com/favicon.ico";
var googleLogoUrl = "https://www.google.com/images/srpr/logo3w.png";

// Fetch the Google favicon.ico file and get the Blob data
var faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
var logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and logoBlob
var zip = Utilities.zip([faviconBlob, logoBlob], "google_images.zip");

Parâmetros

Nome	Tipo	Descrição
blobs	BlobSource[]	Uma matriz de blobs a serem compactados.
name	String	O nome do arquivo ZIP a ser criado.

Retornar

Blob: um novo blob contendo as entradas como um arquivo.

Métodos obsoletos

jsonParse(jsonString)

Obsoleto. A partir de novembro de 2013, foi substituída por JSON.parse()

Retorne um objeto correspondente à string JSON transmitida.

// Returns the object { name: "John Smith", company: "Virginia Company"}
var obj = Utilities.jsonParse('{"name":"John Smith","company":"Virginia Company"}');

Parâmetros

Nome	Tipo	Descrição
jsonString	String	Uma representação de String de um objeto JavaScript para desserializar.

Retornar

Object: uma representação do objeto JavaScript da entrada.

---

jsonStringify(obj)

Obsoleto. A partir de novembro de 2013, foi substituída por JSON.stringify()

Retorne uma string JSON do objeto transmitido.

// Logs: {"name":"John Smith","company":"Virginia Company"}
var person = { name: "John Smith", company: "Virginia Company" };
var json = Utilities.jsonStringify(person);
Logger.log(json);

Parâmetros

Nome	Tipo	Descrição
obj	Object	o objeto JavaScript a ser serializado em JSON

Retornar

String: um objeto JavaScript serializado em JSON