Esse 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 e segura para a Web em base64 em uma matriz de bytes UTF-8. |
base64DecodeWebSafe(encoded, charset) | Byte[] | Decodifica uma string codificada e segura para a Web em base64 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 fornecida em um conjunto de caracteres específico. |
base64EncodeWebSafe(data) | String | Gera uma string codificada e segura para a Web em base64 com base na matriz de bytes fornecida. |
base64EncodeWebSafe(data) | String | Gera uma string codificada e segura para a Web em base64 a partir da string fornecida. |
base64EncodeWebSafe(data, charset) | String | Gera uma string codificada e segura para a Web em base64 a partir da string fornecida em um conjunto de caracteres específico. |
computeDigest(algorithm, value) | Byte[] | Calcule um resumo usando o algoritmo especificado no valor Byte[] especificado. |
computeDigest(algorithm, value) | Byte[] | Calcule um resumo usando o algoritmo especificado no valor String especificado. |
computeDigest(algorithm, value, charset) | Byte[] | Calcule um resumo usando o algoritmo especificado no valor String especificado com o conjunto de caracteres determinado. |
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[] | Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados. |
computeHmacSignature(algorithm, value, key) | Byte[] | Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados. |
computeHmacSignature(algorithm, value, key, charset) | Byte[] | Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados. |
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 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 de Blob fornecidos e os retorna em um novo objeto Blob . |
gzip(blob, name) | Blob | gzip compacta os dados de 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 | Crie um novo objeto Blob usando uma matriz de bytes e um tipo de conteúdo. |
newBlob(data, contentType, name) | Blob | Crie 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, tipo de conteúdo e nome. |
parseCsv(csv) | String[][] | Retorna uma representação da matriz 2D tabular de uma string CSV. |
parseCsv(csv, delimiter) | String[][] | Retorna uma representação tabular de matriz 2D 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 na classe SimpleDateFormat da edição padrão Java. |
sleep(milliseconds) | void | Fica suspenso por um número especificado de milissegundos. |
ungzip(blob) | Blob | Descompacta um objeto Blob e retorna um Blob contendo os dados descompactados. |
unzip(blob) | Blob[] | Toma um Blob que representa um arquivo zip e retorna seus arquivos componentes. |
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. |
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. |
Retorno
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 | Uma Charset especificando o conjunto de caracteres da entrada. |
Retorno
Byte[]
: os dados brutos representados pelo argumento codificado em base64 como uma matriz de bytes.
base64DecodeWebSafe(encoded)
Decodifica uma string codificada e segura para a Web em base64 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 da Web para decodificar. |
Retorno
Byte[]
: os dados brutos representados pelo argumento codificado seguro para Web em base64 como uma matriz de bytes.
base64DecodeWebSafe(encoded, charset)
Decodifica uma string codificada e segura para a Web em base64 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 da Web a serem decodificados. |
charset | Charset | Uma Charset especificando o conjunto de caracteres da entrada. |
Retorno
Byte[]
: os dados brutos representados pelo argumento codificado seguro para 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 comum aceita por várias ferramentas que não aceitam dados binários. O Base 64 é normalmente usado 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.base64Encode(blob.getBytes()); Logger.log(encoded);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
data | Byte[] | Um byte[] de dados a codificar. |
Retorno
String
: a representação codificada em base64 dos dados transmitidos.
base64Encode(data)
Gera uma string codificada em base64 a partir da string fornecida. Base 64 é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. A base 64 é normalmente usada em protocolos de Internet, 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. |
Retorno
String
: a representação codificada em base64 da string de entrada.
base64Encode(data, charset)
Gera uma string codificada em base64 a partir da string fornecida em um conjunto de caracteres específico. Um charset é uma maneira de codificar caracteres de modo que eles possam ser codificados. Isso geralmente é feito em um formato binário, que geralmente pode ser incompatível com determinados protocolos de transmissão de dados. Para tornar os dados compatíveis, eles geralmente são codificados em base 64, que é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. O Base 64 é normalmente 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.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 | Uma Charset especificando o conjunto de caracteres da entrada. |
Retorno
String
: a representação codificada em base64 da string de entrada com o Charset
especificado.
base64EncodeWebSafe(data)
Gera uma string codificada e segura para a Web em base64 com base na matriz de bytes fornecida. A codificação Base 64 é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. A segurança para a Web Base 64 é frequentemente usada 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 a serem codificados. |
Retorno
String
: a representação codificada e segura para a Web de base64 dos dados transmitidos.
base64EncodeWebSafe(data)
Gera uma string codificada e segura para a Web em base64 a partir da string fornecida. A base 64 é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. A base 64 segura para a Web é usada com frequência em protocolos de 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. |
Retorno
String
: a representação codificada e segura para a Web de base64 da string de entrada.
base64EncodeWebSafe(data, charset)
Gera uma string codificada e segura para a Web em base64 a partir da string fornecida em um conjunto de caracteres específico. Um charset é uma maneira de codificar caracteres de modo que eles possam ser codificados. Eles geralmente são feitos em um formato binário, que geralmente pode ser incompatível com determinados protocolos de transmissão de dados. Para tornar os dados compatíveis, eles geralmente são codificados em base 64, que é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. A base 64 segura para a Web é comumente usada 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 | Uma Charset especificando o conjunto de caracteres da entrada. |
Retorno
String
: a representação codificada e segura para a Web de base64 da string de entrada com o Charset
fornecido.
computeDigest(algorithm, value)
Calcule um resumo usando o algoritmo especificado no valor 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. |
Retorno
Byte[]
: um byte[] que representa o resumo de saída.
computeDigest(algorithm, value)
Calcule um resumo usando o algoritmo especificado no valor 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. |
Retorno
Byte[]
: um byte[] que representa o resumo de saída.
computeDigest(algorithm, value, charset)
Calcule um resumo usando o algoritmo especificado no valor String
especificado com o conjunto de caracteres determinado.
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 | Uma Charset que representa o conjunto de caracteres de entrada. |
Retorno
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 o qual gerar um hash. |
key | Byte[] | Uma chave para gerar o hash. |
Retorno
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 o qual gerar um hash. |
key | String | Uma chave para gerar o hash. |
Retorno
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 o qual gerar um hash. |
key | String | Uma chave para gerar o hash. |
charset | Charset | Uma Charset que representa o conjunto de caracteres de entrada. |
Retorno
Byte[]
: um byte[] que representa a assinatura de saída.
computeHmacSignature(algorithm, value, key)
Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados.
// 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 o qual gerar um hash. |
key | Byte[] | Uma chave para gerar o hash. |
Retorno
Byte[]
: um byte[] que representa a assinatura de saída.
computeHmacSignature(algorithm, value, key)
Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados.
// 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 o qual gerar um hash. |
key | String | Uma chave para gerar o hash. |
Retorno
Byte[]
: um byte[] que representa a assinatura de saída.
computeHmacSignature(algorithm, value, key, charset)
Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados.
// 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 o qual gerar um hash. |
key | String | Uma chave para gerar o hash. |
charset | Charset | Uma Charset que representa o conjunto de caracteres de entrada. |
Retorno
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 o qual gerar um hash. |
key | String | Uma chave formatada em PEM a ser usada para gerar a assinatura. |
Retorno
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 o qual gerar um hash. |
key | String | Uma chave formatada em PEM a ser usada para gerar a assinatura. |
charset | Charset | Uma Charset que representa o conjunto de caracteres de entrada. |
Retorno
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 o qual gerar um hash. |
key | String | Uma chave formatada em PEM a ser usada para gerar a assinatura. |
Retorno
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 o qual gerar um hash. |
key | String | Uma chave formatada em PEM a ser usada para gerar a assinatura. |
charset | Charset | Uma Charset que representa o conjunto de caracteres de entrada. |
Retorno
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 o qual gerar um hash. |
key | String | Uma chave formatada em PEM a ser usada para gerar a assinatura. |
Retorno
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 o qual gerar um hash. |
key | String | Uma chave formatada em PEM a ser usada para gerar a assinatura. |
charset | Charset | Uma Charset que representa o conjunto de caracteres de entrada. |
Retorno
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. Acesse 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 . |
Retorno
String
: a data de entrada como uma string formatada.
formatString(template, args)
Executa 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 a serem usados para preencher os espaços reservados "%" no modelo. |
Retorno
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
tempo e espaço. Sendo assim, 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(); };
Retorno
String
: uma representação de string do UUID.
gzip(blob)
gzip
compacta os dados de 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 . |
Retorno
gzip(blob, name)
gzip
compacta os dados de Blob
fornecidos e os retorna em um novo objeto Blob
. Essa versão do método permite especificar um nome de arquivo.
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 que será criado. |
Retorno
newBlob(data)
Cria um novo objeto Blob a partir de uma matriz de bytes. Blobs são usados em muitas APIs do Apps Script que recebem 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. |
Retorno
Blob
: o blob recém-criado.
newBlob(data, contentType)
Crie um novo objeto Blob usando uma matriz de bytes e um tipo de conteúdo. Blobs são usados em muitas APIs do Apps Script que usam 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 . |
Retorno
Blob
: o blob recém-criado.
newBlob(data, contentType, name)
Crie um novo objeto Blob a partir de uma matriz de bytes, tipo de conteúdo e nome. Blobs são usados em muitas APIs do Apps Script que usam 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 é null . |
name | String | O nome do blob pode ser null . |
Retorno
Blob
: o blob recém-criado.
newBlob(data)
Cria um novo objeto Blob a partir de uma string. Blobs são usados em muitas APIs do Apps Script que recebem 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, presumida UTF-8. |
Retorno
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. 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'; // 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, presumida UTF-8. |
contentType | String | O tipo de conteúdo do blob pode ser null . |
Retorno
Blob
: o blob recém-criado.
newBlob(data, contentType, name)
Cria um novo objeto Blob a partir de uma string, tipo de conteúdo e nome. 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'; // 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, presumida UTF-8. |
contentType | String | O tipo de conteúdo do blob pode ser null . |
name | String | O nome do blob pode ser null . |
Retorno
Blob
: o blob recém-criado.
parseCsv(csv)
Retorna uma representação da 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 | Uma string que contém dados de uma ou várias linhas em formato de valores separados por vírgulas (CSV). |
Retorno
String[][]
: uma matriz bidimensional contendo os valores na string CSV.
parseCsv(csv, delimiter)
Retorna uma representação tabular de matriz 2D 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 | Uma string que contém dados de uma ou várias linhas em formato de valores separados por vírgulas (CSV). |
delimiter | Char | Entre valores. |
Retorno
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 na classe SimpleDateFormat
da edição padrão Java. Para mais informações, consulte a classe SimpleDateFormat
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 . |
Retorno
Date
: a string de entrada como uma data.
sleep(milliseconds)
Fica suspenso por um número especificado de milissegundos. Coloca o script em suspensão imediatamente pelo 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 | Número de milissegundos de suspensão. |
ungzip(blob)
Descompacta um objeto Blob
e retorna um Blob
contendo os dados descompactados.
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 de dados compactados. |
Retorno
unzip(blob)
Toma um Blob que representa um arquivo zip e retorna seus arquivos componentes.
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. |
Retorno
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 para compactar. |
Retorno
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. Essa versão do método permite especificar um nome de arquivo.
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 para compactar. |
name | String | O nome do arquivo ZIP a ser criado. |
Retorno
Blob
: um novo blob contendo as entradas como um arquivo.