Class Utilities

Utilidades

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

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 arreglo 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 segura para la Web en Base64 en un arreglo de bytes UTF-8.
base64DecodeWebSafe(encoded, charset)	Byte[]	Decodifica una string codificada segura para la Web 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 cadena codificada en base 64 a partir de la cadena determinada en un grupo de caracteres específico.
base64EncodeWebSafe(data)	String	Genera una string codificada y segura en la Web en Base64 a partir del array de bytes determinado.
base64EncodeWebSafe(data)	String	Genera una string codificada segura para la Web en Base64 a partir de la string determinada.
base64EncodeWebSafe(data, charset)	String	Genera una string codificada segura para la Web en Base64 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 mediante el algoritmo especificado en el valor String especificado con el grupo de caracteres determinado.
computeHmacSha256Signature(value, key)	Byte[]	Firma el valor proporcionado mediante HMAC-SHA256 con la clave dada.
computeHmacSha256Signature(value, key)	Byte[]	Firma el valor proporcionado mediante HMAC-SHA256 con la clave dada.
computeHmacSha256Signature(value, key, charset)	Byte[]	Firma el valor proporcionado mediante HMAC-SHA256 con la clave y el grupo de caracteres especificados.
computeHmacSignature(algorithm, value, key)	Byte[]	Calcula un código de autenticación de mensajes con el algoritmo indicado en la clave y el valor especificados.
computeHmacSignature(algorithm, value, key)	Byte[]	Calcula un código de autenticación de mensajes con el algoritmo indicado en la clave y el valor especificados.
computeHmacSignature(algorithm, value, key, charset)	Byte[]	Calcula un código de autenticación de mensajes con el algoritmo indicado en la clave y el valor especificados.
computeRsaSha1Signature(value, key)	Byte[]	Firma el valor proporcionado mediante RSA-SHA1 con la clave proporcionada.
computeRsaSha1Signature(value, key, charset)	Byte[]	Firma el valor proporcionado mediante RSA-SHA1 con la clave y el charset especificados.
computeRsaSha256Signature(value, key)	Byte[]	Firma el valor proporcionado mediante RSA-SHA256 con la clave proporcionada.
computeRsaSha256Signature(value, key, charset)	Byte[]	Firma el valor proporcionado mediante RSA-SHA256 con la clave proporcionada.
computeRsaSignature(algorithm, value, key)	Byte[]	Firma el valor proporcionado mediante el algoritmo de RSA especificado con la clave proporcionada.
computeRsaSignature(algorithm, value, key, charset)	Byte[]	Firma el valor proporcionado mediante el algoritmo de RSA especificado con la clave y el charset especificados.
formatDate(date, timeZone, format)	String	Da formato a la fecha según la especificación descrita en la clase SimpleDateFormat de Java SE.
formatString(template, args)	String	Realiza un formato de string similar a sprintf con strings de formato de estilo '%'.
getUuid()	String	Obtén un UUID como una cadena (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 objeto Blob nuevo a partir de un array de bytes.
newBlob(data, contentType)	Blob	Crea un objeto Blob nuevo 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	Crea un objeto Blob nuevo 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 tabular en 2D de un array de una cadena CSV.
parseCsv(csv, delimiter)	String[][]	Muestra una representación tabular de un array en 2D de una cadena CSV con un delimitador personalizado.
parseDate(date, timeZone, format)	Date	Analiza la fecha de string proporcionada según la especificación que se describe en la clase SimpleDateFormat de la edición estándar de Java.
sleep(milliseconds)	void	Se suspende durante una cantidad específica de milisegundos.
ungzip(blob)	Blob	Descomprime un objeto Blob y muestra un Blob que contiene los datos sin comprimir.
unzip(blob)	Blob[]	Toma un BLOB que representa un archivo ZIP y muestra los archivos que lo componen.
zip(blobs)	Blob	Crea un objeto BLOB nuevo que es un archivo ZIP que contiene los datos de los BLOB que se pasaron.
zip(blobs, name)	Blob	Crea un objeto BLOB nuevo 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 correspondiente a la string JSON que se pasa.
jsonStringify(obj)	String	Muestra una string JSON del objeto que se pasó.

Documentación detallada

base64Decode(encoded)

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

Devolvedor

Byte[]: Son los datos sin procesar que representa 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 cadena de datos que se decodificará.
charset	Charset	Un Charset que especifique el charset de la entrada

Devolvedor

Byte[]: Son los datos sin procesar que representa el argumento codificado en Base64 como un array de bytes.

---

base64DecodeWebSafe(encoded)

Decodifica una string codificada segura para la Web en Base64 en un arreglo 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 decodifican.

Devolvedor

Byte[]: los datos sin procesar que representa el argumento codificado seguro para la Web en Base64 como un array de bytes.

---

base64DecodeWebSafe(encoded, charset)

Decodifica una string codificada segura para la Web 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 decodificará.
charset	Charset	Un Charset que especifique el charset de la entrada

Devolvedor

Byte[]: los datos sin procesar que representa el argumento codificado seguro para la Web en Base64 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 que aceptan una variedad de herramientas que no pueden aceptar datos binarios. Por lo general, Base 64 se usa 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 para codificar.

Devolvedor

String: Es la representación codificada en Base64 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 que acepta una variedad de herramientas que no puede aceptar datos binarios. Por lo general, Base 64 se usa en protocolos de Internet, como el 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 va a codificar

Devolvedor

String: es la representación codificada en base 64 de la string de entrada.

---

base64Encode(data, charset)

Genera una cadena codificada en base 64 a partir de la cadena determinada en un grupo de caracteres específico. Un charset es una forma de codificar caracteres, de modo que puedan codificarse. Por lo general, se realizan en un formato binario que, por lo 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. Por lo general, Base 64 se usa 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	Es la cadena de datos que se codificará.
charset	Charset	Un Charset que especifique el charset de la entrada

Devolvedor

String: es la representación codificada en base64 de la string de entrada con el Charset determinado.

---

base64EncodeWebSafe(data)

Genera una string codificada y segura en la Web en Base64 a partir del array de bytes determinado. Base 64 es una codificación común que acepta una variedad de herramientas que no pueden aceptar datos binarios. El sistema seguro para la Web en Base64 suele usarse en protocolos de Internet como el correo electrónico y 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[]	Es un array de bytes de datos para codificar.

Devolvedor

String: es la representación codificada y segura para la Web en Base64 de los datos que se pasaron.

---

base64EncodeWebSafe(data)

Genera una string codificada segura para la Web en Base64 a partir de la string determinada. Base 64 es una codificación común que aceptan una variedad de herramientas que no pueden aceptar datos binarios. El sistema seguro para la Web en Base64 suele usarse en protocolos de Internet como el correo electrónico y 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 va a codificar

Devolvedor

String: la representación codificada y segura para la Web en Base64 de la string de entrada.

---

base64EncodeWebSafe(data, charset)

Genera una string codificada segura para la Web en Base64 a partir de la string determinada en un grupo de caracteres específico. Un charset es una forma de codificar caracteres para que puedan codificarse. Por lo general, estas acciones se realizan en formato binario y que, por lo general, pueden ser incompatibles con ciertos protocolos de transmisión de datos. Para hacer 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. Por lo general, los protocolos de Internet seguros para la Web Base64 se usan en protocolos de Internet como el correo electrónico y 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	Es la cadena de datos que se codificará.
charset	Charset	Un Charset que especifique el charset de la entrada

Devolvedor

String: es la representación codificada y segura para la Web en Base64 de la string de entrada con el Charset determinado.

---

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[]	Un valor de string de entrada para el que se calcula un resumen.

Devolvedor

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	Un valor de string de entrada para el que se calcula un resumen.

Devolvedor

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

---

computeDigest(algorithm, value, charset)

Calcula un resumen mediante 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	Un valor de string de entrada para el que se calcula un resumen.
charset	Charset	Una Charset que representa el grupo de caracteres de entrada

Devolvedor

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

---

computeHmacSha256Signature(value, key)

Firma el valor proporcionado mediante 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 genera un hash.
key	Byte[]	Una clave para generar el hash.

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeHmacSha256Signature(value, key)

Firma el valor proporcionado mediante 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 genera un hash.
key	String	Una clave para generar el hash.

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeHmacSha256Signature(value, key, charset)

Firma el valor proporcionado mediante HMAC-SHA256 con la clave y el grupo de caracteres especificados.

// 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 genera un hash.
key	String	Una clave para generar el hash.
charset	Charset	Una Charset que representa el grupo de caracteres de entrada

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeHmacSignature(algorithm, value, key)

Calcula un código de autenticación de mensajes con el algoritmo indicado 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 un hash en el valor de entrada.
value	Byte[]	El valor de entrada para el que se genera un hash.
key	Byte[]	Una clave para generar el hash.

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeHmacSignature(algorithm, value, key)

Calcula un código de autenticación de mensajes con el algoritmo indicado 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 un hash en el valor de entrada.
value	String	El valor de entrada para el que se genera un hash.
key	String	Una clave para generar el hash.

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeHmacSignature(algorithm, value, key, charset)

Calcula un código de autenticación de mensajes con el algoritmo indicado 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 un hash en el valor de entrada.
value	String	El valor de entrada para el que se genera un hash.
key	String	Una clave para generar el hash.
charset	Charset	Una Charset que representa el grupo de caracteres de entrada

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeRsaSha1Signature(value, key)

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

// 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 genera un hash.
key	String	Una clave con formato PEM para generar la firma.

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeRsaSha1Signature(value, key, charset)

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

// 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 genera un hash.
key	String	Una clave con formato PEM para generar la firma.
charset	Charset	Una Charset que representa el grupo de caracteres de entrada

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeRsaSha256Signature(value, key)

Firma el valor proporcionado mediante RSA-SHA256 con la clave proporcionada.

// 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 genera un hash.
key	String	Una clave con formato PEM para generar la firma.

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeRsaSha256Signature(value, key, charset)

Firma el valor proporcionado mediante RSA-SHA256 con la clave proporcionada.

// 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 genera un hash.
key	String	Una clave con formato PEM para generar la firma.
charset	Charset	Una Charset que representa el grupo de caracteres de entrada

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeRsaSignature(algorithm, value, key)

Firma el valor proporcionado mediante el algoritmo de RSA especificado con la clave proporcionada.

// 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 un hash en el valor de entrada.
value	String	El valor de entrada para el que se genera un hash.
key	String	Una clave con formato PEM para generar la firma.

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

computeRsaSignature(algorithm, value, key, charset)

Firma el valor proporcionado mediante el algoritmo de RSA especificado con la clave y el charset 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 un hash en el valor de entrada.
value	String	El valor de entrada para el que se genera un hash.
key	String	Una clave con formato PEM para generar la firma.
charset	Charset	Una Charset que representa el grupo de caracteres de entrada

Devolvedor

Byte[]: Es un byte[] que representa la firma de salida.

---

formatDate(date, timeZone, format)

Da 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 formatear como una cadena.
timeZone	String	Es la zona horaria de salida del resultado.
format	String	Un formato según la especificación SimpleDateFormat.

Devolvedor

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

---

formatString(template, args)

Realiza un formato de string similar a sprintf con strings de formato de estilo '%'.

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

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

Parámetros

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

Devolvedor

String: Es la string con formato.

---

getUuid()

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

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

Devolvedor

String: Es una representación de cadena 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.

Devolvedor

Blob: Es un Blob nuevo 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á.

Devolvedor

Blob: Es un Blob nuevo que contiene los datos comprimidos.

---

newBlob(data)

Crea un objeto Blob nuevo 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.

Devolvedor

Blob: Es el BLOB recién creado.

---

newBlob(data, contentType)

Crea un objeto Blob nuevo 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.

Devolvedor

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.

Devolvedor

Blob: Es el BLOB recién creado.

---

newBlob(data)

Crea un objeto Blob nuevo 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	La string del BLOB, se supone que es UTF-8.

Devolvedor

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	La string del BLOB, se supone que es UTF-8.
contentType	String	El tipo de contenido del BLOB puede ser null.

Devolvedor

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	La string del BLOB, se supone que es UTF-8.
contentType	String	El tipo de contenido del BLOB puede ser null.
name	String	El nombre del BLOB puede ser null.

Devolvedor

Blob: Es el BLOB recién creado.

---

parseCsv(csv)

Muestra una representación tabular en 2D de un array de una cadena 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	Una string que contiene datos de una o varias líneas en formato de valores separados por comas (CSV).

Devolvedor

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

---

parseCsv(csv, delimiter)

Muestra una representación tabular de un array en 2D de una cadena 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	Una string que contiene datos de una o varias líneas en formato de valores separados por comas (CSV).
delimiter	Char	Entre valores

Devolvedor

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 que se describe en la clase SimpleDateFormat de la edición estándar de Java. 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	Es un valor de cadena para analizar como una fecha.
timeZone	String	La zona horaria de salida.
format	String	El formato de fecha según la especificación SimpleDateFormat.

Devolvedor

Date: Es la string de entrada como una fecha.

---

sleep(milliseconds)

Se suspende durante una cantidad específica de milisegundos. Inmediatamente, la secuencia de comandos se suspende durante la cantidad especificada de milisegundos. 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 para suspenderse.

---

ungzip(blob)

Descomprime un objeto Blob y muestra un 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.

Devolvedor

Blob: Es una Blob que representa los datos descomprimidos.

---

unzip(blob)

Toma un BLOB que representa un archivo ZIP y muestra los archivos que lo componen.

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.

Devolvedor

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

---

zip(blobs)

Crea un objeto BLOB nuevo 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 conjunto de BLOB para comprimir.

Devolvedor

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

---

zip(blobs, name)

Crea un objeto BLOB nuevo 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 conjunto de BLOB para comprimir.
name	String	El nombre del archivo ZIP que se creará.

Devolvedor

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

Métodos obsoletos

jsonParse(jsonString)

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

Muestra un objeto correspondiente a la string JSON que se pasa.

// 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 cadena de un objeto JavaScript para deserializar.

Devolvedor

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

---

jsonStringify(obj)

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

Muestra una string JSON del objeto que se pasó.

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

Devolvedor

String: Un objeto de JavaScript serializado en JSON