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