Class Utilities

Utilidades

Este servicio proporciona utilidades para la codificación y decodificación de strings, el formato de fecha, la manipulación de JSON y otras tareas diversas.

Propiedades

Propiedad	Tipo	Descripción
Charset	Charset
DigestAlgorithm	DigestAlgorithm
MacAlgorithm	MacAlgorithm
RsaAlgorithm	RsaAlgorithm

Métodos

Método	Tipo de datos que se muestra	Descripción breve
base64Decode(encoded)	Byte[]	Decodifica una string codificada en base 64 en un array de bytes UTF-8.
base64Decode(encoded, charset)	Byte[]	Decodifica una string codificada en base 64 en un array de bytes en un grupo de caracteres específico.
base64DecodeWebSafe(encoded)	Byte[]	Decodifica una string codificada en base web de 64 elementos en un array de bytes UTF-8.
base64DecodeWebSafe(encoded, charset)	Byte[]	Decodifica una string codificada en la Web segura en base 64 en un array de bytes en un grupo de caracteres específico.
base64Encode(data)	String	Genera una string codificada en base 64 a partir del array de bytes determinado.
base64Encode(data)	String	Genera una string codificada en base 64 a partir de la string determinada.
base64Encode(data, charset)	String	Genera una string codificada en base 64 a partir de la string determinada en un grupo de caracteres específico.
base64EncodeWebSafe(data)	String	Genera una string codificada segura en la Web en base 64 a partir del array de bytes determinado.
base64EncodeWebSafe(data)	String	Genera una string codificada en base a la Web segura de base 64 a partir de la string determinada.
base64EncodeWebSafe(data, charset)	String	Genera una string codificada segura en la Web en base 64 a partir de la string determinada en un grupo de caracteres específico.
computeDigest(algorithm, value)	Byte[]	Calcula un resumen con el algoritmo especificado en el valor Byte[] especificado.
computeDigest(algorithm, value)	Byte[]	Calcula un resumen con el algoritmo especificado en el valor String especificado.
computeDigest(algorithm, value, charset)	Byte[]	Calcula un resumen con el algoritmo especificado en el valor String especificado con el grupo de caracteres determinado.
computeHmacSha256Signature(value, key)	Byte[]	Firma el valor proporcionado usando HMAC-SHA256 con la clave dada.
computeHmacSha256Signature(value, key)	Byte[]	Firma el valor proporcionado usando HMAC-SHA256 con la clave dada.
computeHmacSha256Signature(value, key, charset)	Byte[]	Firma el valor proporcionado usando HMAC-SHA256 con la clave y el grupo de caracteres dados.
computeHmacSignature(algorithm, value, key)	Byte[]	Procesa un código de autenticación de mensajes con el algoritmo especificado en la clave y el valor especificados.
computeHmacSignature(algorithm, value, key)	Byte[]	Procesa un código de autenticación de mensajes con el algoritmo especificado en la clave y el valor especificados.
computeHmacSignature(algorithm, value, key, charset)	Byte[]	Procesa un código de autenticación de mensajes con el algoritmo especificado en la clave y el valor especificados.
computeRsaSha1Signature(value, key)	Byte[]	Firma el valor proporcionado mediante RSA-SHA1 con la clave determinada.
computeRsaSha1Signature(value, key, charset)	Byte[]	Firma el valor proporcionado mediante RSA-SHA1 con la clave y el charset dados.
computeRsaSha256Signature(value, key)	Byte[]	Firma el valor proporcionado con RSA-SHA256 con la clave determinada.
computeRsaSha256Signature(value, key, charset)	Byte[]	Firma el valor proporcionado con RSA-SHA256 con la clave determinada.
computeRsaSignature(algorithm, value, key)	Byte[]	Firma el valor proporcionado con el algoritmo RSA especificado con la clave determinada.
computeRsaSignature(algorithm, value, key, charset)	Byte[]	Firma el valor proporcionado con el algoritmo RSA especificado con la clave y el conjunto de caracteres especificados.
formatDate(date, timeZone, format)	String	Aplica formato a la fecha según la especificación descrita en la clase SimpleDateFormat de Java SE.
formatString(template, args)	String	Realiza el formato de string similar a sprintf con strings de formato "%".
getUuid()	String	Obtén un UUID como una string (equivalente a usar el método java.util.UUID.randomUUID()).
gzip(blob)	Blob	gzip comprime los datos Blob proporcionados y los muestra en un objeto Blob nuevo.
gzip(blob, name)	Blob	gzip comprime los datos Blob proporcionados y los muestra en un objeto Blob nuevo.
newBlob(data)	Blob	Crea un nuevo objeto BLOB a partir de un array de bytes.
newBlob(data, contentType)	Blob	Crear un nuevo objeto BLOB a partir de un array de bytes y un tipo de contenido
newBlob(data, contentType, name)	Blob	Crea un objeto BLOB nuevo a partir de un array de bytes, un tipo de contenido y un nombre.
newBlob(data)	Blob	Crear un nuevo objeto BLOB a partir de una string
newBlob(data, contentType)	Blob	Crea un objeto BLOB nuevo a partir de una string y un tipo de contenido.
newBlob(data, contentType, name)	Blob	Crea un objeto BLOB nuevo a partir de una string, un tipo de contenido y un nombre.
parseCsv(csv)	String[][]	Muestra una representación de arreglo en 2D de una string CSV.
parseCsv(csv, delimiter)	String[][]	Muestra una representación de arreglo en 2D tabular de una string de CSV con un delimitador personalizado.
parseDate(date, timeZone, format)	Date	Analiza la fecha de string proporcionada según la especificación descrita en la clase SimpleDateFormat de Java Standard Edition.
sleep(milliseconds)	void	Se suspende durante un número específico de milisegundos.
ungzip(blob)	Blob	Descomprime un objeto Blob y muestra una Blob que contiene los datos sin comprimir.
unzip(blob)	Blob[]	Toma un BLOB que representa un archivo ZIP y muestra sus archivos componentes.
zip(blobs)	Blob	Crea un nuevo objeto BLOB que es un archivo ZIP que contiene los datos de los BLOB que se pasaron.
zip(blobs, name)	Blob	Crea un nuevo objeto BLOB que es un archivo ZIP que contiene los datos de los BLOB que se pasaron.

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
jsonParse(jsonString)	Object	Muestra un objeto que corresponde a la string JSON pasada.
jsonStringify(obj)	String	Muestra una string JSON del objeto pasado.

Documentación detallada

base64Decode(encoded)

Decodifica una string codificada en base 64 en un array 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

Nombre	Tipo	Descripción
encoded	String	Un array de bytes de datos para decodificar.

Volver

Byte[]: los datos sin procesar representados por el argumento codificado en base64 como un array de bytes.

---

base64Decode(encoded, charset)

Decodifica una string codificada en base 64 en un array de bytes en un grupo 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

Nombre	Tipo	Descripción
encoded	String	Es la string de datos que se decodificará.
charset	Charset	Un Charset que especifica el charset de la entrada.

Volver

Byte[]: los datos sin procesar representados por el argumento codificado en base64 como un array de bytes.

---

base64DecodeWebSafe(encoded)

Decodifica una string codificada en base web de 64 elementos en un array 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

Nombre	Tipo	Descripción
encoded	String	Es un array de bytes de datos seguros para la Web que se decodificarán.

Volver

Byte[]: los datos sin procesar representados por el argumento codificado en Web-safe de forma segura como un array de bytes.

---

base64DecodeWebSafe(encoded, charset)

Decodifica una string codificada en la Web segura en base 64 en un array de bytes en un grupo 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

Nombre	Tipo	Descripción
encoded	String	Es la string de datos seguros para la Web que se decodifican.
charset	Charset	Un Charset que especifica el charset de la entrada.

Volver

Byte[]: los datos sin procesar representados por el argumento codificado en Web-safe de forma segura como un array de bytes.

---

base64Encode(data)

Genera una string codificada en base 64 a partir del array de bytes determinado. Base 64 es una codificación común aceptada por una variedad de herramientas que no pueden aceptar datos binarios. Base 64 se usa comúnmente en protocolos de Internet como correo electrónico, HTTP o en 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

Nombre	Tipo	Descripción
data	Byte[]	Un byte[] de datos que se codificarán.

Volver

String: Es la representación codificada en base 64 de los datos que se pasaron.

---

base64Encode(data)

Genera una string codificada en base 64 a partir de la string determinada. Base 64 es una codificación común aceptada por una variedad de herramientas que no pueden aceptar datos binarios. Base 64 se usa comúnmente en protocolos de Internet como correo electrónico, HTTP o en documentos XML.

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

Parámetros

Nombre	Tipo	Descripción
data	String	Cadena que se codificará

Volver

String: Es la representación codificada en Base64 de la string de entrada.

---

base64Encode(data, charset)

Genera una string codificada en base 64 a partir de la string determinada en un grupo de caracteres específico. Un charset es una forma de codificar caracteres de modo que se puedan codificar. Por lo general, se realizan en formato binario, que en general puede ser incompatible con ciertos protocolos de transmisión de datos. Para que los datos sean compatibles, generalmente se codifican en Base 64, que es una codificación común aceptada por una variedad de herramientas que no pueden aceptar datos binarios. Base 64 se usa comúnmente en protocolos de Internet como correo electrónico, HTTP o en 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

Nombre	Tipo	Descripción
data	String	La string de datos que se codificará.
charset	Charset	Un Charset que especifica el charset de la entrada.

Volver

String: Es la representación codificada en base 64 de la string de entrada con el Charset determinado.

---

base64EncodeWebSafe(data)

Genera una string codificada segura en la Web en base 64 a partir del array de bytes determinado. Base 64 es una codificación común aceptada por una variedad de herramientas que no pueden aceptar datos binarios. La base 64 segura para la Web se usa comúnmente en protocolos de Internet como correo electrónico, HTTP o en 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

Nombre	Tipo	Descripción
data	Byte[]	Un array de bytes de datos que se codificarán.

Volver

String: La representación codificada segura en la Web en base64 de los datos que se pasaron.

---

base64EncodeWebSafe(data)

Genera una string codificada en base a la Web segura de base 64 a partir de la string determinada. Base 64 es una codificación común aceptada por una variedad de herramientas que no pueden aceptar datos binarios. La seguridad web base 64 se usa comúnmente en protocolos de Internet como correo electrónico, HTTP o en documentos XML.

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

Parámetros

Nombre	Tipo	Descripción
data	String	Cadena que se codificará

Volver

String: Es la representación codificada segura en la Web de base-64 de la string de entrada.

---

base64EncodeWebSafe(data, charset)

Genera una string codificada segura en la Web en base 64 a partir de la string determinada en un grupo de caracteres específico. Un charset es una forma de codificar caracteres de modo que se puedan codificar. Por lo general, se realizan en formato binario, que en general puede ser incompatible con ciertos protocolos de transmisión de datos. Para que los datos sean compatibles, generalmente se codifican en Base 64, que es una codificación común aceptada por una variedad de herramientas que no pueden aceptar datos binarios. La seguridad web base 64 se usa comúnmente en protocolos de Internet como correo electrónico, HTTP o en 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

Nombre	Tipo	Descripción
data	String	La string de datos que se codificará.
charset	Charset	Un Charset que especifica el charset de la entrada.

Volver

String: es la representación codificada segura en la Web en base64 de la string de entrada con la Charset determinada.

---

computeDigest(algorithm, value)

Calcula un resumen con el algoritmo especificado en el 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

Nombre	Tipo	Descripción
algorithm	DigestAlgorithm	Un DigestAlgorithm para usar.
value	Byte[]	Valor de string de entrada para calcular un resumen.

Volver

Byte[]: Es un byte[] que representa el resumen de salida.

---

computeDigest(algorithm, value)

Calcula un resumen con el algoritmo especificado en el valor String especificado.

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

Parámetros

Nombre	Tipo	Descripción
algorithm	DigestAlgorithm	Un DigestAlgorithm para usar.
value	String	Valor de string de entrada para calcular un resumen.

Volver

Byte[]: Es un byte[] que representa el resumen de salida.

---

computeDigest(algorithm, value, charset)

Calcula un resumen con el algoritmo especificado en el valor String especificado con el grupo de caracteres determinado.

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

Parámetros

Nombre	Tipo	Descripción
algorithm	DigestAlgorithm	Un DigestAlgorithm para usar.
value	String	Valor de string de entrada para calcular un resumen.
charset	Charset	Un Charset que representa el grupo de caracteres de entrada.

Volver

Byte[]: Es un byte[] que representa el resumen de salida.

---

computeHmacSha256Signature(value, key)

Firma el valor proporcionado usando HMAC-SHA256 con la clave dada.

// 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

Nombre	Tipo	Descripción
value	Byte[]	El valor de entrada para el que se generará un hash.
key	Byte[]	Una clave para generar el hash.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeHmacSha256Signature(value, key)

Firma el valor proporcionado usando HMAC-SHA256 con la clave dada.

// 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

Nombre	Tipo	Descripción
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave para generar el hash.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeHmacSha256Signature(value, key, charset)

Firma el valor proporcionado usando HMAC-SHA256 con la clave y el grupo de caracteres dados.

// 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

Nombre	Tipo	Descripción
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave para generar el hash.
charset	Charset	Un Charset que representa el grupo de caracteres de entrada.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeHmacSignature(algorithm, value, key)

Procesa un código de autenticación de mensajes con el algoritmo especificado en la clave y el 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

Nombre	Tipo	Descripción
algorithm	MacAlgorithm	Un algoritmo MacAlgorithm para usar con el fin de generar un hash del valor de entrada.
value	Byte[]	El valor de entrada para el que se generará un hash.
key	Byte[]	Una clave para generar el hash.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeHmacSignature(algorithm, value, key)

Procesa un código de autenticación de mensajes con el algoritmo especificado en la clave y el 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

Nombre	Tipo	Descripción
algorithm	MacAlgorithm	Un algoritmo MacAlgorithm para usar con el fin de generar un hash del valor de entrada.
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave para generar el hash.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeHmacSignature(algorithm, value, key, charset)

Procesa un código de autenticación de mensajes con el algoritmo especificado en la clave y el 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

Nombre	Tipo	Descripción
algorithm	MacAlgorithm	Un algoritmo MacAlgorithm para usar con el fin de generar un hash del valor de entrada.
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave para generar el hash.
charset	Charset	Un Charset que representa el grupo de caracteres de entrada.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeRsaSha1Signature(value, key)

Firma el valor proporcionado mediante RSA-SHA1 con la clave determinada.

// 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

Nombre	Tipo	Descripción
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeRsaSha1Signature(value, key, charset)

Firma el valor proporcionado mediante RSA-SHA1 con la clave y el charset dados.

// 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

Nombre	Tipo	Descripción
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.
charset	Charset	Un Charset que representa el grupo de caracteres de entrada.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeRsaSha256Signature(value, key)

Firma el valor proporcionado con RSA-SHA256 con la clave determinada.

// 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

Nombre	Tipo	Descripción
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeRsaSha256Signature(value, key, charset)

Firma el valor proporcionado con RSA-SHA256 con la clave determinada.

// 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

Nombre	Tipo	Descripción
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.
charset	Charset	Un Charset que representa el grupo de caracteres de entrada.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeRsaSignature(algorithm, value, key)

Firma el valor proporcionado con el algoritmo RSA especificado con la clave determinada.

// 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

Nombre	Tipo	Descripción
algorithm	RsaAlgorithm	Un algoritmo RsaAlgorithm para usar con el fin de generar un hash del valor de entrada.
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

computeRsaSignature(algorithm, value, key, charset)

Firma el valor proporcionado con el algoritmo RSA especificado con la clave y el conjunto de caracteres especificados.

// 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

Nombre	Tipo	Descripción
algorithm	RsaAlgorithm	Un algoritmo RsaAlgorithm para usar con el fin de generar un hash del valor de entrada.
value	String	El valor de entrada para el que se generará un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.
charset	Charset	Un Charset que representa el grupo de caracteres de entrada.

Volver

Byte[]: Un byte[] que representa la firma del resultado.

---

formatDate(date, timeZone, format)

Aplica formato a la fecha según la especificación descrita en la clase SimpleDateFormat de Java SE. Consulta la especificación en 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

Nombre	Tipo	Descripción
date	Date	Un Date para dar formato de string
timeZone	String	La zona horaria de salida del resultado.
format	String	Un formato según la especificación de SimpleDateFormat.

Volver

String: Es la fecha de entrada como una string con formato.

---

formatString(template, args)

Realiza el formato de string similar a sprintf con strings de formato "%".

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

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

Parámetros

Nombre	Tipo	Descripción
template	String	La string de formato que controla lo que se muestra.
args	Object...	Objetos que se usan para completar los marcadores de posición “%” en la plantilla

Volver

String: Es la string con formato.

---

getUuid()

Obtén un UUID como una string (equivalente a usar el método java.util.UUID.randomUUID()). No se garantiza que este identificador sea único en todo momento y espacio. Por lo tanto, no lo uses en situaciones en las que se requiera unicidad garantizada.

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

Volver

String: Es una representación de string del UUID.

---

gzip(blob)

gzip comprime los datos Blob proporcionados y los muestra en un objeto Blob nuevo.

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

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

Parámetros

Nombre	Tipo	Descripción
blob	BlobSource	Un objeto Blob para comprimir con gzip

Volver

Blob: Es una Blob nueva que contiene los datos comprimidos.

---

gzip(blob, name)

gzip comprime los datos Blob proporcionados y los muestra en un objeto Blob nuevo. Esta versión del método permite especificar un nombre de archivo.

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

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

Parámetros

Nombre	Tipo	Descripción
blob	BlobSource	Un objeto Blob para comprimir con gzip
name	String	El nombre del archivo gzip que se creará.

Volver

Blob: Es una Blob nueva que contiene los datos comprimidos.

---

newBlob(data)

Crea un nuevo objeto BLOB a partir de un array de bytes. Los BLOB se usan en muchas API de Apps Script que toman datos binarios 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

Nombre	Tipo	Descripción
data	Byte[]	Los bytes del BLOB.

Volver

Blob: Es el BLOB recién creado.

---

newBlob(data, contentType)

Crear un nuevo objeto BLOB a partir de un array de bytes y un tipo de contenido Los BLOB se usan en muchas API de Apps Script que toman datos binarios 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

Nombre	Tipo	Descripción
data	Byte[]	Los bytes del BLOB.
contentType	String	El tipo de contenido del BLOB puede ser null.

Volver

Blob: Es el BLOB recién creado.

---

newBlob(data, contentType, name)

Crea un objeto BLOB nuevo a partir de un array de bytes, un tipo de contenido y un nombre. Los BLOB se usan en muchas API de Apps Script que toman datos binarios 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

Nombre	Tipo	Descripción
data	Byte[]	Los bytes del BLOB.
contentType	String	- El tipo de contenido del BLOB puede ser null.
name	String	El nombre del BLOB puede ser null.

Volver

Blob: Es el BLOB recién creado.

---

newBlob(data)

Crear un nuevo objeto BLOB a partir de una string Los BLOB se usan en muchas API de Apps Script que toman datos binarios 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

Nombre	Tipo	Descripción
data	String	Es la string del BLOB, supuestamente UTF-8.

Volver

Blob: Es el BLOB recién creado.

---

newBlob(data, contentType)

Crea un objeto BLOB nuevo a partir de una string y un tipo de contenido. Los BLOB se usan en muchas API de Apps Script que toman datos binarios 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

Nombre	Tipo	Descripción
data	String	Es la string del BLOB, supuestamente UTF-8.
contentType	String	El tipo de contenido del BLOB puede ser null.

Volver

Blob: Es el BLOB recién creado.

---

newBlob(data, contentType, name)

Crea un objeto BLOB nuevo a partir de una string, un tipo de contenido y un nombre. Los BLOB se usan en muchas API de Apps Script que toman datos binarios 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

Nombre	Tipo	Descripción
data	String	Es la string del BLOB, supuestamente UTF-8.
contentType	String	El tipo de contenido del BLOB puede ser null.
name	String	El nombre del BLOB puede ser null.

Volver

Blob: Es el BLOB recién creado.

---

parseCsv(csv)

Muestra una representación de arreglo en 2D de una 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

Nombre	Tipo	Descripción
csv	String	Es una string que contiene datos de una o varias líneas en formato de valores separados por comas (CSV).

Volver

String[][]: Es un array bidimensional que contiene los valores de la string CSV.

---

parseCsv(csv, delimiter)

Muestra una representación de arreglo en 2D tabular de una string de CSV con un 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

Nombre	Tipo	Descripción
csv	String	Es una string que contiene datos de una o varias líneas en formato de valores separados por comas (CSV).
delimiter	Char	Entre valores.

Volver

String[][]: Es un array bidimensional que contiene los valores de la string CSV.

---

parseDate(date, timeZone, format)

Analiza la fecha de string proporcionada según la especificación descrita en la clase SimpleDateFormat de Java Standard Edition. Para obtener más información, consulta la clase SimpleDateFormat de 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

Nombre	Tipo	Descripción
date	String	Un valor de string para analizar como una fecha
timeZone	String	La zona horaria de salida.
format	String	El formato de fecha según la especificación SimpleDateFormat.

Volver

Date: Es la string de entrada como una fecha.

---

sleep(milliseconds)

Se suspende durante un número específico de milisegundos. Pone inmediatamente la secuencia de comandos en suspensión durante la cantidad de milisegundos especificada. El valor máximo permitido es 300,000 (o 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

Nombre	Tipo	Descripción
milliseconds	Integer	La cantidad de milisegundos que se suspenderán.

---

ungzip(blob)

Descomprime un objeto Blob y muestra una Blob que contiene los datos sin comprimir.

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

Nombre	Tipo	Descripción
blob	BlobSource	El Blob de los datos comprimidos.

Volver

Blob: Es un Blob que representa los datos descomprimidos.

---

unzip(blob)

Toma un BLOB que representa un archivo ZIP y muestra sus archivos 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

Nombre	Tipo	Descripción
blob	BlobSource	El BLOB del archivo ZIP

Volver

Blob[]: Es un BLOB que representa los BLOB de componentes, cada uno con la ruta de acceso completa dentro del archivo ZIP.

---

zip(blobs)

Crea un nuevo objeto BLOB que es un archivo ZIP que contiene los datos de los BLOB que se pasaron.

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

Nombre	Tipo	Descripción
blobs	BlobSource[]	Un array de BLOB que se comprimirá

Volver

Blob: Es un nuevo BLOB que contiene las entradas como archivo.

---

zip(blobs, name)

Crea un nuevo objeto BLOB que es un archivo ZIP que contiene los datos de los BLOB que se pasaron. Esta versión del método permite especificar un nombre de archivo.

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

Nombre	Tipo	Descripción
blobs	BlobSource[]	Un array de BLOB que se comprimirá
name	String	El nombre del archivo ZIP que se creará.

Volver

Blob: Es un nuevo BLOB que contiene las entradas como archivo.

Métodos obsoletos

jsonParse(jsonString)

Obsoleto. A partir de noviembre de 2013, se reemplazó por JSON.parse()

Muestra un objeto que corresponde a la string JSON pasada.

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

Parámetros

Nombre	Tipo	Descripción
jsonString	String	Representación de string de un objeto de JavaScript que se deserializará.

Volver

Object: Es una representación del objeto de JavaScript de la entrada.

---

jsonStringify(obj)

Obsoleto. A partir de noviembre de 2013, se reemplazó por JSON.stringify()

Muestra una string JSON del objeto pasado.

// 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

Nombre	Tipo	Descripción
obj	Object	el objeto de JavaScript para serializar en JSON

Volver

String: Es un objeto de JavaScript serializado JSON.