Class Utilities

Utilidades

Este servicio proporciona utilidades para codificar/decodificación de cadenas, formato de fecha, manipulación de JSON, y otras tareas misceláneas.

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 cadena codificada en base 64 en un array de bytes en UTF-8.
base64Decode(encoded, charset)	Byte[]	Decodifica una cadena 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 64 segura para la Web en un array de bytes UTF-8.
base64DecodeWebSafe(encoded, charset)	Byte[]	Decodifica una string codificada en base 64 segura para la Web 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 arreglo de bytes determinado.
base64Encode(data)	String	Genera una cadena codificada en base 64 a partir de la cadena 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 en base 64 segura para la Web a partir del arreglo de bytes determinado.
base64EncodeWebSafe(data)	String	Genera una cadena codificada en Base64 segura para la Web a partir de la cadena determinada.
base64EncodeWebSafe(data, charset)	String	Genera una cadena codificada en base 64 segura para la Web a partir de la cadena determinada en un grupo de caracteres específico.
computeDigest(algorithm, value)	Byte[]	Calcula un resumen mediante el uso del algoritmo especificado en el valor Byte[] especificado.
computeDigest(algorithm, value)	Byte[]	Calcula un resumen mediante el uso del algoritmo especificado en el valor String especificado.
computeDigest(algorithm, value, charset)	Byte[]	Calcula un resumen usando 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 determinada.
computeHmacSha256Signature(value, key)	Byte[]	Firma el valor proporcionado usando HMAC-SHA256 con la clave determinada.
computeHmacSha256Signature(value, key, charset)	Byte[]	Firma el valor proporcionado usando 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 usando el algoritmo especificado en la clave especificada y valor.
computeHmacSignature(algorithm, value, key)	Byte[]	Calcula un código de autenticación de mensajes usando el algoritmo especificado en la clave especificada y valor.
computeHmacSignature(algorithm, value, key, charset)	Byte[]	Calcula un código de autenticación de mensajes usando el algoritmo especificado en la clave especificada y valor.
computeRsaSha1Signature(value, key)	Byte[]	Firma el valor proporcionado usando RSA-SHA1 con la clave determinada.
computeRsaSha1Signature(value, key, charset)	Byte[]	Firma el valor proporcionado usando RSA-SHA1 con la clave y el charset especificados.
computeRsaSha256Signature(value, key)	Byte[]	Firma el valor proporcionado usando RSA-SHA256 con la clave determinada.
computeRsaSha256Signature(value, key, charset)	Byte[]	Firma el valor proporcionado usando RSA-SHA256 con la clave determinada.
computeRsaSignature(algorithm, value, key)	Byte[]	Firma el valor proporcionado usando el algoritmo de RSA especificado con la clave determinada.
computeRsaSignature(algorithm, value, key, charset)	Byte[]	Firma el valor proporcionado usando 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 formateo de cadena similar a sprintf con cadenas 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 de Blob proporcionados y los muestra en un objeto Blob nuevo.
gzip(blob, name)	Blob	gzip: comprime los datos de 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 cadena.
newBlob(data, contentType)	Blob	Crea un objeto Blob nuevo a partir de una cadena y un tipo de contenido.
newBlob(data, contentType, name)	Blob	Crea un objeto Blob nuevo a partir de una cadena, un tipo de contenido y un nombre.
parseCsv(csv)	String[][]	Muestra una representación de un array en 2D tabular de una cadena CSV.
parseCsv(csv, delimiter)	String[][]	Muestra una representación de un array en 2D tabular de una cadena CSV con un delimitador personalizado.
parseDate(date, timeZone, format)	Date	Analiza la fecha de cadena proporcionada según la especificación descrita en el estándar de Java. Edición de clase SimpleDateFormat.
sleep(milliseconds)	void	Se suspende durante un número específico de milisegundos.
ungzip(blob)	Blob	Descomprime un objeto Blob y muestra un Blob que contiene el archivo de datos no estructurados.
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 Blobs pasados.
zip(blobs, name)	Blob	Crea un nuevo objeto Blob que es un archivo ZIP que contiene los datos de los Blobs pasados.

Métodos obsoletos

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

Documentación detallada

base64Decode(encoded)

Decodifica una cadena codificada en base 64 en un array de bytes en 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[]: Son los datos sin procesar representados por el argumento codificado en base-64 como un array de bytes.

---

base64Decode(encoded, charset)

Decodifica una cadena 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 conjunto de caracteres de la entrada.

Volver

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

---

base64DecodeWebSafe(encoded)

Decodifica una string codificada en base 64 segura para la Web 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	Un array de bytes de datos seguros para la Web que se decodificarán.

Volver

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

---

base64DecodeWebSafe(encoded, charset)

Decodifica una string codificada en base 64 segura para la Web 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 cadena de datos seguros para la Web que se decodificará.
charset	Charset	Un Charset que especifique el conjunto de caracteres de la entrada.

Volver

Byte[]: Son los datos sin procesar representados por 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 arreglo de bytes determinado. Base 64 es una codificación común son aceptados 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 para codificar

Volver

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

---

base64Encode(data)

Genera una cadena codificada en base 64 a partir de la cadena 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 con frecuencia en 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 cadena codificada en base 64 a partir de la cadena determinada en un grupo de caracteres específico. Conjunto de caracteres es una forma de codificar caracteres de modo que puedan codificarse. Estas se suelen realizar que, por lo general, pueden no ser compatibles 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 son aceptados 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	Es la cadena de datos que se codificará.
charset	Charset	Un Charset que especifique el conjunto de caracteres de la entrada.

Volver

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

---

base64EncodeWebSafe(data)

Genera una string codificada en base 64 segura para la Web a partir del arreglo de bytes determinado. El Base 64 es un Es la codificación que aceptan diversas herramientas que no pueden aceptar datos binarios. Base 64 seguro para la Web es de uso general en protocolos de Internet como correo electrónico, HTTP o 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[]	Array de bytes de datos para codificar.

Volver

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

---

base64EncodeWebSafe(data)

Genera una cadena codificada en Base64 segura para la Web a partir de la cadena determinada. Base 64 es una codificación común son aceptados por una variedad de herramientas que no pueden aceptar datos binarios. Base 64 es seguro para la Web usarse en protocolos de Internet como correo electrónico, HTTP o 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 en Base64 de la string de entrada que es segura para la Web.

---

base64EncodeWebSafe(data, charset)

Genera una cadena codificada en base 64 segura para la Web a partir de la cadena determinada en un grupo de caracteres específico. Un conjunto de caracteres es una forma de codificar caracteres de modo que puedan codificarse. Estas suelen ser se realizan en formato binario, lo que, por lo general, puede no ser compatible con ciertas transmisiones de datos protocolos. Para que los datos sean compatibles, generalmente se codifican en base 64, que es un codificación común aceptada por una variedad de herramientas que no pueden aceptar datos binarios. Base 64 seguro para la Web se usa en protocolos de Internet como correo electrónico, HTTP o 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 conjunto de caracteres de la entrada.

Volver

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 mediante el uso del 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	Es un DigestAlgorithm para usar.
value	Byte[]	Un valor de cadena de entrada para el que se calculará un resumen.

Volver

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

---

computeDigest(algorithm, value)

Calcula un resumen mediante el uso del 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	Es un DigestAlgorithm para usar.
value	String	Un valor de cadena de entrada para el que se calculará un resumen.

Volver

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

---

computeDigest(algorithm, value, charset)

Calcula un resumen usando 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	Es un DigestAlgorithm para usar.
value	String	Un valor de cadena de entrada para el que se calculará un resumen.
charset	Charset	Un objeto Charset que representa el grupo de caracteres de entrada.

Volver

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

---

computeHmacSha256Signature(value, key)

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

// 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[]	Valor de entrada para el que se genera un hash.
key	Byte[]	La clave con la que se puede generar el hash.

Volver

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

---

computeHmacSha256Signature(value, key)

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

// 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	Valor de entrada para el que se genera un hash.
key	String	La clave con la que se puede generar el hash.

Volver

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

---

computeHmacSha256Signature(value, key, charset)

Firma el valor proporcionado usando 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	Valor de entrada para el que se genera un hash.
key	String	La clave con la que se puede generar el hash.
charset	Charset	Un objeto Charset que representa el grupo de caracteres de entrada.

Volver

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

---

computeHmacSignature(algorithm, value, key)

Calcula un código de autenticación de mensajes usando el algoritmo especificado en la clave especificada y valor.

// 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 que se usará para generar un hash en el valor de entrada.
value	Byte[]	Valor de entrada para el que se genera un hash.
key	Byte[]	La clave con la que se puede generar el hash.

Volver

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

---

computeHmacSignature(algorithm, value, key)

Calcula un código de autenticación de mensajes usando el algoritmo especificado en la clave especificada y valor.

// 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 que se usará para generar un hash en el valor de entrada.
value	String	Valor de entrada para el que se genera un hash.
key	String	La clave con la que se puede generar el hash.

Volver

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

---

computeHmacSignature(algorithm, value, key, charset)

Calcula un código de autenticación de mensajes usando el algoritmo especificado en la clave especificada y valor.

// 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 que se usará para generar un hash en el valor de entrada.
value	String	Valor de entrada para el que se genera un hash.
key	String	La clave con la que se puede generar el hash.
charset	Charset	Un objeto Charset que representa el grupo de caracteres de entrada.

Volver

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

---

computeRsaSha1Signature(value, key)

Firma el valor proporcionado usando 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	Valor de entrada para el que se genera un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.

Volver

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

---

computeRsaSha1Signature(value, key, charset)

Firma el valor proporcionado usando 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	Valor de entrada para el que se genera un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.
charset	Charset	Un objeto Charset que representa el grupo de caracteres de entrada.

Volver

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

---

computeRsaSha256Signature(value, key)

Firma el valor proporcionado usando 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	Valor de entrada para el que se genera un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.

Volver

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

---

computeRsaSha256Signature(value, key, charset)

Firma el valor proporcionado usando 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	Valor de entrada para el que se genera un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.
charset	Charset	Un objeto Charset que representa el grupo de caracteres de entrada.

Volver

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

---

computeRsaSignature(algorithm, value, key)

Firma el valor proporcionado usando el algoritmo de 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 que se usará para generar un hash en el valor de entrada.
value	String	Valor de entrada para el que se genera un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.

Volver

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

---

computeRsaSignature(algorithm, value, key, charset)

Firma el valor proporcionado usando 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 que se usará para generar un hash en el valor de entrada.
value	String	Valor de entrada para el que se genera un hash.
key	String	Una clave con formato PEM que se usará para generar la firma.
charset	Charset	Un objeto Charset que representa el grupo de caracteres de entrada.

Volver

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. Por favor, visita las especificaciones 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 del resultado.
format	String	Un formato según la especificación SimpleDateFormat.

Volver

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

---

formatString(template, args)

Realiza un formateo de cadena similar a sprintf con cadenas 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 el '%' los marcadores de posición en la plantilla.

Volver

String: es la cadena 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 los uses en situaciones en las que se requiera una 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 cadena del UUID.

---

gzip(blob)

gzip: comprime los datos de 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 un Blob nuevo que contiene los datos comprimidos.

---

gzip(blob, name)

gzip: comprime los datos de 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 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 APIs de Apps Script que toman los 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)

Crea un objeto Blob nuevo a partir de un array de bytes y un tipo de contenido. Los BLOB se usan en muchas Apps Script APIs 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 apps APIs de secuencias de comandos 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)

Crea un objeto Blob nuevo a partir de una cadena. Los BLOB se usan en muchas APIs de Apps Script que toman los 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 cadena del BLOB, que se supone es UTF-8.

Volver

Blob: es el BLOB recién creado.

---

newBlob(data, contentType)

Crea un objeto Blob nuevo a partir de una cadena y un tipo de contenido. Los BLOB se usan en muchas Apps Script APIs 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 cadena del BLOB, que se supone es 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 cadena, un tipo de contenido y un nombre. Los BLOB se usan en muchas apps APIs de secuencias de comandos 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 cadena del BLOB, que se supone es 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 un array en 2D tabular 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 cadena que contiene datos de una o varias líneas en valores separados por comas (CSV) de un conjunto de datos tengan un formato común.

Volver

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

---

parseCsv(csv, delimiter)

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

Volver

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

---

parseDate(date, timeZone, format)

Analiza la fecha de cadena proporcionada según la especificación descrita en el estándar de Java. Edición de clase SimpleDateFormat. 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.

Volver

Date: Es la cadena de entrada como una fecha.

---

sleep(milliseconds)

Se suspende durante un número específico de milisegundos. El guion se suspende de inmediato para una cantidad específica 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	Es la cantidad de milisegundos para suspenderlo.

---

ungzip(blob)

Descomprime un objeto Blob y muestra un Blob que contiene el archivo de datos no estructurados.

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 componente, cada uno nombrado con la ruta completa dentro del ZIP.

---

zip(blobs)

Crea un nuevo objeto Blob que es un archivo ZIP que contiene los datos de los Blobs pasados.

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 para comprimir.

Volver

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

---

zip(blobs, name)

Crea un nuevo objeto Blob que es un archivo ZIP que contiene los datos de los Blobs pasados. Esta 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 para comprimir.
name	String	El nombre del archivo ZIP que se creará.

Volver

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

Métodos obsoletos

jsonParse(jsonString)

Obsoleto. A partir de noviembre de 2013, reemplazado por JSON.parse()

Muestra un objeto correspondiente a la cadena JSON que se pasó.

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

Volver

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

---

jsonStringify(obj)

Obsoleto. A partir de noviembre de 2013, reemplazado por JSON.stringify()

Muestra una cadena 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

Volver

String: Es un objeto de JavaScript serializado JSON.