Esta página foi traduzida pela API Cloud Translation.

Class Utilities

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