Se usó la API de Cloud Translation para traducir esta página.

Class Utilities

Este servicio proporciona utilidades para la codificación y decodificación de cadenas, el formato de fecha, la 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 UTF-8.
`base64Decode(encoded, charset)`	`Byte[]`	Decodifica una cadena codificada en base 64 en un array de bytes en un conjunto de caracteres específico.
`base64DecodeWebSafe(encoded)`	`Byte[]`	Decodifica una cadena codificada en base 64 segura para la Web en un array de bytes UTF-8.
`base64DecodeWebSafe(encoded, charset)`	`Byte[]`	Decodifica una cadena codificada en base64 segura para la Web en un array de bytes en un conjunto de caracteres específico.
`base64Encode(data)`	`String`	Genera una cadena codificada en base 64 a partir del array de bytes determinado.
`base64Encode(data)`	`String`	Genera una cadena codificada en base 64 a partir de la cadena especificada.
`base64Encode(data, charset)`	`String`	Genera una cadena codificada en base 64 a partir de la cadena especificada en un conjunto de caracteres específico.
`base64EncodeWebSafe(data)`	`String`	Genera una cadena codificada en base 64 segura para la Web a partir del array de bytes determinado.
`base64EncodeWebSafe(data)`	`String`	Genera una cadena codificada en base 64 segura para la Web a partir de la cadena especificada.
`base64EncodeWebSafe(data, charset)`	`String`	Genera una cadena codificada en base 64 segura para la Web a partir de la cadena especificada en un conjunto 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 conjunto de caracteres determinado.
`computeHmacSha256Signature(value, key)`	`Byte[]`	Firma el valor proporcionado con HMAC-SHA256 con la clave proporcionada.
`computeHmacSha256Signature(value, key)`	`Byte[]`	Firma el valor proporcionado con HMAC-SHA256 con la clave proporcionada.
`computeHmacSha256Signature(value, key, charset)`	`Byte[]`	Firma el valor proporcionado con HMAC-SHA256 con la clave y el conjunto de caracteres determinados.
`computeHmacSignature(algorithm, value, key)`	`Byte[]`	Calcula un código de autenticación de mensajes con el algoritmo especificado en la clave y el valor especificados.
`computeHmacSignature(algorithm, value, key)`	`Byte[]`	Calcula 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[]`	Calcula 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 con RSA-SHA1 con la clave proporcionada.
`computeRsaSha1Signature(value, key, charset)`	`Byte[]`	Firma el valor proporcionado con RSA-SHA1 con la clave y el conjunto de caracteres especificados.
`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 de RSA especificado con la clave determinada.
`computeRsaSignature(algorithm, value, key, charset)`	`Byte[]`	Firma el valor proporcionado con el algoritmo de RSA especificado con la clave y el conjunto de caracteres determinados.
`formatDate(date, timeZone, format)`	`String`	Da formato a la fecha según la especificación que se describe en la clase SimpleDateFormat de Java SE.
`formatString(template, args)`	`String`	Realiza el formato de cadenas similares 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 `Blob` proporcionados y los muestra en un nuevo objeto `Blob`.
`gzip(blob, name)`	`Blob`	`gzip`: Comprime los datos `Blob` proporcionados y los muestra en un nuevo objeto `Blob`.
`newBlob(data)`	`Blob`	Crea un objeto Blob nuevo a partir de un array de bytes.
`newBlob(data, contentType)`	`Blob`	Crea un nuevo objeto Blob a partir de un array de bytes y un tipo de contenido.
`newBlob(data, contentType, name)`	`Blob`	Crea un nuevo objeto Blob 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 nuevo objeto Blob a partir de una cadena y un tipo de contenido.
`newBlob(data, contentType, name)`	`Blob`	Crea un nuevo objeto Blob a partir de una cadena, un tipo de contenido y un nombre.
`parseCsv(csv)`	`String[][]`	Muestra una representación de array tabular 2D de una cadena CSV.
`parseCsv(csv, delimiter)`	`String[][]`	Muestra una representación de array tabular 2D de una cadena CSV con un delimitador personalizado.
`parseDate(date, timeZone, format)`	`Date`	Analiza la fecha de cadena proporcionada según la especificación que se describe en la clase `SimpleDateFormat` de la edición estándar de Java.
`sleep(milliseconds)`	`void`	Entra en suspensión durante la cantidad de milisegundos especificada.
`ungzip(blob)`	`Blob`	Descomprime un objeto `Blob` y muestra un `Blob` que contiene los datos no comprimidos.
`unzip(blob)`	`Blob[]`	Toma un BLOB que representa un archivo ZIP y muestra sus archivos de 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 que corresponde 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 UTF-8.

// This is the base64 encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
const 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`	Es 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 conjunto de caracteres específico.

// This is the base64 encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

const 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 especifica 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 cadena 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 グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const 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 en base 64 seguro para la Web como un array de bytes.

`base64DecodeWebSafe(encoded, charset)`

Decodifica una cadena codificada en base64 segura para la Web en un array de bytes en un conjunto de caracteres específico.

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const 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 especifica el conjunto de caracteres de la entrada.

Volver

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

`base64Encode(data)`

Genera una cadena codificada en base 64 a partir del array de bytes determinado. Base 64 es una codificación común que aceptan varias herramientas que no pueden aceptar datos binarios. La base 64 se usa comúnmente en protocolos de Internet, como el correo electrónico, HTTP o en documentos XML.

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const 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 base 64 de los datos pasados.

`base64Encode(data)`

Genera una cadena codificada en base 64 a partir de la cadena especificada. Base 64 es una codificación común que aceptan varias herramientas que no pueden aceptar datos binarios. La base 64 se usa comúnmente en protocolos de Internet, como correo electrónico, HTTP o en documentos XML.

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

Parámetros

Nombre	Tipo	Descripción
`data`	`String`	Es la cadena que se codificará.

Volver

String: Es la representación codificada en base 64 de la cadena de entrada.

`base64Encode(data, charset)`

Genera una cadena codificada en base 64 a partir de la cadena especificada en un conjunto de caracteres específico. Un conjunto de caracteres es una forma de codificar caracteres para que se puedan codificar. Por lo general, se realizan en un formato binario, que puede ser incompatible con ciertos protocolos de transmisión de datos. Para que los datos sean compatibles, por lo general, se codifican en base 64, que es una codificación común que aceptan varias herramientas que no pueden aceptar datos binarios. La base 64 se usa comúnmente en protocolos de Internet, como el correo electrónico, HTTP o en documentos XML.

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
const 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 especifica el conjunto de caracteres de la entrada.

Volver

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

`base64EncodeWebSafe(data)`

Genera una cadena codificada en base 64 segura para la Web a partir del array de bytes determinado. Base 64 es una codificación común que aceptan varias herramientas que no pueden aceptar datos binarios. La codificación web-safe de Base 64 se usa con frecuencia en protocolos de Internet, como correo electrónico, HTTP o en documentos XML.

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const 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.

Volver

String: Es la representación codificada en base 64 segura para la Web de los datos pasados.

`base64EncodeWebSafe(data)`

Genera una cadena codificada en base 64 segura para la Web a partir de la cadena especificada. Base 64 es una codificación común que aceptan varias herramientas que no pueden aceptar datos binarios. La codificación Base 64 segura para la Web se usa comúnmente en protocolos de Internet, como el correo electrónico, HTTP o en documentos XML.

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

Parámetros

Nombre	Tipo	Descripción
`data`	`String`	Es la cadena que se codificará.

Volver

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

`base64EncodeWebSafe(data, charset)`

Genera una cadena codificada en base 64 segura para la Web a partir de la cadena especificada en un conjunto de caracteres específico. Un conjunto de caracteres es una forma de codificar caracteres para que se puedan codificar. Por lo general, se realizan en un formato binario, que 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 que aceptan varias herramientas que no pueden aceptar datos binarios. La codificación Base 64 segura para la Web se usa comúnmente en protocolos de Internet, como el correo electrónico, HTTP o en documentos XML.

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log
const 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 especifica el conjunto de caracteres de la entrada.

Volver

String: Es la representación codificada en base64 segura para la Web de la cadena de entrada con el Charset determinado.

`computeDigest(algorithm, value)`

Calcula un resumen con el algoritmo especificado en el valor Byte[] especificado.

const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');  // == base64encode("input to hash")
const digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input);
Logger.log(digest);

Parámetros

Nombre	Tipo	Descripción
`algorithm`	`DigestAlgorithm`	Un `DigestAlgorithm` para usar.
`value`	`Byte[]`	Es un valor de cadena de entrada para el que se debe 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.

const 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`	Es un valor de cadena de entrada para el que se debe 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 conjunto de caracteres determinado.

const 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`	Es un valor de cadena de entrada para el que se debe calcular un resumen.
`charset`	`Charset`	Un `Charset` que representa el conjunto de caracteres de entrada.

Volver

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

`computeHmacSha256Signature(value, key)`

Firma el valor proporcionado con HMAC-SHA256 con la clave proporcionada.

// This writes an array of bytes to the log.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSha256Signature(input, key);
Logger.log(signature);

Parámetros

Nombre	Tipo	Descripción
`value`	`Byte[]`	Es el valor de entrada para el que se generará un hash.
`key`	`Byte[]`	Es una clave que se usa para generar el hash.

Volver

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

`computeHmacSha256Signature(value, key)`

Firma el valor proporcionado con HMAC-SHA256 con la clave proporcionada.

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSha256Signature(
    'this is my input',
    'my key - use a stronger one',
);
Logger.log(signature);

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	Es el valor de entrada para el que se generará un hash.
`key`	`String`	Es una clave que se usa para generar el hash.

Volver

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

`computeHmacSha256Signature(value, key, charset)`

Firma el valor proporcionado con HMAC-SHA256 con la clave y el conjunto de caracteres determinados.

// This writes an array of bytes to the log.
const 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`	Es el valor de entrada para el que se generará un hash.
`key`	`String`	Es una clave que se usa para generar el hash.
`charset`	`Charset`	Un `Charset` que representa el conjunto 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 con el algoritmo especificado en la clave y el valor especificados.

// This writes an array of bytes to the log.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    input,
    key,
);
Logger.log(signature);

Parámetros

Nombre	Tipo	Descripción
`algorithm`	`MacAlgorithm`	Es un algoritmo `MacAlgorithm` que se usa para generar un hash del valor de entrada.
`value`	`Byte[]`	Es el valor de entrada para el que se generará un hash.
`key`	`Byte[]`	Es una clave que se usa para 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 con el algoritmo especificado en la clave y el valor especificados.

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    'input to hash',
    'key',
);
Logger.log(signature);

Parámetros

Nombre	Tipo	Descripción
`algorithm`	`MacAlgorithm`	Es un algoritmo `MacAlgorithm` que se usa para generar un hash del valor de entrada.
`value`	`String`	Es el valor de entrada para el que se generará un hash.
`key`	`String`	Es una clave que se usa para 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 con el algoritmo especificado en la clave y el valor especificados.

// This writes an array of bytes to the log.
const 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`	Es un algoritmo `MacAlgorithm` que se usa para generar un hash del valor de entrada.
`value`	`String`	Es el valor de entrada para el que se generará un hash.
`key`	`String`	Es una clave que se usa para generar el hash.
`charset`	`Charset`	Un `Charset` que representa el conjunto de caracteres de entrada.

Volver

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

`computeRsaSha1Signature(value, key)`

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	Es el valor de entrada para el que se generará un hash.
`key`	`String`	Es 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 con RSA-SHA1 con la clave y el conjunto de caracteres especificados.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

Parámetros

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

Volver

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

`computeRsaSha256Signature(value, key)`

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	Es el valor de entrada para el que se generará un hash.
`key`	`String`	Es 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 con RSA-SHA256 con la clave determinada.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Parámetros

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

Volver

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

`computeRsaSignature(algorithm, value, key)`

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Parámetros

Nombre	Tipo	Descripción
`algorithm`	`RsaAlgorithm`	Es un algoritmo `RsaAlgorithm` que se usa para generar un hash del valor de entrada.
`value`	`String`	Es el valor de entrada para el que se generará un hash.
`key`	`String`	Es 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 con el algoritmo de RSA especificado con la clave y el conjunto de caracteres determinados.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

Parámetros

Nombre	Tipo	Descripción
`algorithm`	`RsaAlgorithm`	Es un algoritmo `RsaAlgorithm` que se usa para generar un hash del valor de entrada.
`value`	`String`	Es el valor de entrada para el que se generará un hash.
`key`	`String`	Es una clave con formato PEM que se usará para generar la firma.
`charset`	`Charset`	Un `Charset` que representa el conjunto 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 que se describe 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.
const 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 como una cadena.
`timeZone`	`String`	Es la zona horaria de salida del resultado.
`format`	`String`	Es un formato según la especificación `SimpleDateFormat`.

Volver

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

`formatString(template, args)`

Realiza el formato de cadenas similares 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...`	Son los objetos que se usarán para completar 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 momento y espacio. Por lo tanto, no lo 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.
const myDataObject = {
  tempId: Utilities.getUuid(),
};

Volver

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

`gzip(blob)`

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

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

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

Parámetros

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

Volver

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

`gzip(blob, name)`

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

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

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

Parámetros

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

Volver

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

`newBlob(data)`

Crea un objeto Blob nuevo a partir de un array de bytes. Los blobs se usan en muchas APIs 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)`

Crea un nuevo objeto Blob a partir de un array de bytes y un tipo de contenido. Los blobs se usan en muchas APIs 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`	Es el tipo de contenido del BLOB, puede ser `null`.

Volver

Blob: Es el BLOB recién creado.

`newBlob(data, contentType, name)`

Crea un nuevo objeto Blob a partir de un array de bytes, un tipo de contenido y un nombre. Los blobs se usan en muchas APIs 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`	Es 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 blobs se usan en muchas APIs 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 cadena del blob, que se supone que es UTF-8.

Volver

Blob: Es el BLOB recién creado.

`newBlob(data, contentType)`

Crea un nuevo objeto Blob a partir de una cadena y un tipo de contenido. Los blobs se usan en muchas APIs 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 cadena del blob, que se supone que es UTF-8.
`contentType`	`String`	Es el tipo de contenido del BLOB, puede ser `null`.

Volver

Blob: Es el BLOB recién creado.

`newBlob(data, contentType, name)`

Crea un nuevo objeto Blob a partir de una cadena, un tipo de contenido y un nombre. Los blobs se usan en muchas APIs 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 cadena del blob, que se supone que es UTF-8.
`contentType`	`String`	Es el tipo de contenido del BLOB, puede ser `null`.
`name`	`String`	Es el nombre del blob, puede ser `null`.

Volver

Blob: Es el BLOB recién creado.

`parseCsv(csv)`

Muestra una representación de array tabular 2D de una cadena CSV.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a,b,c\nd,e,f';
const data = Utilities.parseCsv(csvString);

Parámetros

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

Volver

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

`parseCsv(csv, delimiter)`

Muestra una representación de array tabular 2D de una cadena CSV con un delimitador personalizado.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a\tb\tc\nd\te\tf';
const data = Utilities.parseCsv(csvString, '\t');

Parámetros

Nombre	Tipo	Descripción
`csv`	`String`	Es una cadena que contiene datos de una sola línea 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 cadena CSV.

`parseDate(date, timeZone, format)`

Analiza la fecha de cadena 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.
const 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 que se analizará como una fecha.
`timeZone`	`String`	La zona horaria de salida.
`format`	`String`	Es el formato de fecha según la especificación `SimpleDateFormat`.

Volver

Date: Es la cadena de entrada como una fecha.

`sleep(milliseconds)`

Entra en suspensión durante la cantidad de milisegundos especificada. Suspende la secuencia de comandos de inmediato durante la cantidad de milisegundos especificada. El valor máximo permitido es 300000 (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 que se suspenderán.

`ungzip(blob)`

Descomprime un objeto Blob y muestra un Blob que contiene los datos no comprimidos.

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

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

// Uncompress the data.
const uncompressedBlob = Utilities.ungzip(gzipBlob);

Parámetros

Nombre	Tipo	Descripción
`blob`	`BlobSource`	El `Blob` de 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 de componentes.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

// This now unzips the blobs
const 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 el nombre de la ruta de acceso completa dentro del ZIP.

`zip(blobs)`

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

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob]);

Parámetros

Nombre	Tipo	Descripción
`blobs`	`BlobSource[]`	Es un array de objetos blob que se comprimen.

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 versión del método permite especificar un nombre de archivo.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

Parámetros

Nombre	Tipo	Descripción
`blobs`	`BlobSource[]`	Es un array de objetos blob que se comprimen.
`name`	`String`	Es 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, se reemplazó por JSON.parse()

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

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

Parámetros

Nombre	Tipo	Descripción
`jsonString`	`String`	Es una representación de cadena de un objeto JavaScript que se debe deserializar.

Volver

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

`jsonStringify(obj)`

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

Muestra una cadena JSON del objeto que se pasó.

// Logs: {"name":"John Smith","company":"Virginia Company"}
const person = {
  name: 'John Smith',
  company: 'Virginia Company',
};
const json = Utilities.jsonStringify(person);
Logger.log(json);

Parámetros

Nombre	Tipo	Descripción
`obj`	`Object`	el objeto JavaScript que se serializará a JSON

Volver

String: Un objeto JavaScript serializado en JSON