Questo servizio fornisce utilità per la codifica e la decodifica delle stringhe, la formattazione della data, la manipolazione JSON e altre attività varie.
Proprietà
Proprietà | Tipo | Descrizione |
---|---|---|
Charset | Charset | |
DigestAlgorithm | DigestAlgorithm | |
MacAlgorithm | MacAlgorithm | |
RsaAlgorithm | RsaAlgorithm |
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
base64Decode(encoded) | Byte[] | Decodifica una stringa con codifica Base64 in un array di byte UTF-8. |
base64Decode(encoded, charset) | Byte[] | Decodifica una stringa con codifica Base64 in una matrice di byte in un set di caratteri specifico. |
base64DecodeWebSafe(encoded) | Byte[] | Decodifica una stringa con codifica Base64 sicura per il web in un array di byte UTF-8. |
base64DecodeWebSafe(encoded, charset) | Byte[] | Decodifica una stringa con codifica Base64 sicura per il web in un array di byte in un set di caratteri specifico. |
base64Encode(data) | String | Genera una stringa con codifica in base 64 dall'array di byte specificato. |
base64Encode(data) | String | Genera una stringa codificata in base-64 dalla stringa specificata. |
base64Encode(data, charset) | String | Genera una stringa codificata in base-64 dalla stringa specificata in un set di caratteri specifico. |
base64EncodeWebSafe(data) | String | Genera una stringa codificata sicura per il web in Base64 dall'array di byte specificato. |
base64EncodeWebSafe(data) | String | Genera una stringa codificata in base-64 sicura per il web dalla stringa specificata. |
base64EncodeWebSafe(data, charset) | String | Genera una stringa codificata con protezione web Base64 dalla stringa specificata in un set di caratteri specifico. |
computeDigest(algorithm, value) | Byte[] | Calcola un digest utilizzando l'algoritmo specificato sul valore Byte[] specificato. |
computeDigest(algorithm, value) | Byte[] | Calcola un digest utilizzando l'algoritmo specificato sul valore String specificato. |
computeDigest(algorithm, value, charset) | Byte[] | Calcola un digest utilizzando l'algoritmo specificato sul valore String specificato con il
set di caratteri specificato. |
computeHmacSha256Signature(value, key) | Byte[] | Firma il valore fornito utilizzando HMAC-SHA256 con la chiave specificata. |
computeHmacSha256Signature(value, key) | Byte[] | Firma il valore fornito utilizzando HMAC-SHA256 con la chiave specificata. |
computeHmacSha256Signature(value, key, charset) | Byte[] | Firma il valore fornito utilizzando HMAC-SHA256 con la chiave e il set di caratteri specificati. |
computeHmacSignature(algorithm, value, key) | Byte[] | Calcola un codice di autenticazione dei messaggi utilizzando l'algoritmo specificato sulla chiave e sul valore specificati. |
computeHmacSignature(algorithm, value, key) | Byte[] | Calcola un codice di autenticazione dei messaggi utilizzando l'algoritmo specificato sulla chiave e sul valore specificati. |
computeHmacSignature(algorithm, value, key, charset) | Byte[] | Calcola un codice di autenticazione dei messaggi utilizzando l'algoritmo specificato sulla chiave e sul valore specificati. |
computeRsaSha1Signature(value, key) | Byte[] | Firma il valore fornito utilizzando RSA-SHA1 con la chiave specificata. |
computeRsaSha1Signature(value, key, charset) | Byte[] | Firma il valore fornito utilizzando RSA-SHA1 con la chiave e il set di caratteri specificati. |
computeRsaSha256Signature(value, key) | Byte[] | Firma il valore fornito utilizzando RSA-SHA256 con la chiave fornita. |
computeRsaSha256Signature(value, key, charset) | Byte[] | Firma il valore fornito utilizzando RSA-SHA256 con la chiave fornita. |
computeRsaSignature(algorithm, value, key) | Byte[] | Firma il valore fornito utilizzando l'algoritmo RSA specificato con la chiave specificata. |
computeRsaSignature(algorithm, value, key, charset) | Byte[] | Firma il valore fornito utilizzando l'algoritmo RSA specificato con la chiave e il set di caratteri specificati. |
formatDate(date, timeZone, format) | String | I formati variano in base alla specifica descritta nella classe SimpleDateFormat di Java SE. |
formatString(template, args) | String | Esegue la formattazione di stringhe di tipo sprintf utilizzando stringhe di formato di tipo "%". |
getUuid() | String | Ottieni un UUID come stringa (equivalente all'utilizzo del metodo java.util.UUID.randomUUID() ). |
gzip(blob) | Blob | gzip comprime i dati Blob forniti e li restituisce in un nuovo oggetto Blob . |
gzip(blob, name) | Blob | gzip comprime i dati Blob forniti e li restituisce in un nuovo oggetto Blob . |
newBlob(data) | Blob | Crea un nuovo oggetto Blob da un array di byte. |
newBlob(data, contentType) | Blob | Crea un nuovo oggetto Blob da un array di byte e da un tipo di contenuto. |
newBlob(data, contentType, name) | Blob | Crea un nuovo oggetto Blob da un array di byte, un tipo di contenuto e un nome. |
newBlob(data) | Blob | Crea un nuovo oggetto Blob da una stringa. |
newBlob(data, contentType) | Blob | Crea un nuovo oggetto Blob da una stringa e da un tipo di contenuti. |
newBlob(data, contentType, name) | Blob | Crea un nuovo oggetto Blob da una stringa, un tipo di contenuti e un nome. |
parseCsv(csv) | String[][] | Restituisce una rappresentazione array 2D tabulare di una stringa CSV. |
parseCsv(csv, delimiter) | String[][] | Restituisce una rappresentazione array 2D tabulare di una stringa CSV utilizzando un delimitatore personalizzato. |
parseDate(date, timeZone, format) | Date | Analizza la data della stringa fornita in base alla specifica descritta nella classe SimpleDateFormat di Java Standard Edition. |
sleep(milliseconds) | void | Sonno per il numero specificato di millisecondi. |
ungzip(blob) | Blob | Decomprime un oggetto Blob e restituisce un Blob contenente i dati non compressi. |
unzip(blob) | Blob[] | Recupera un BLOB che rappresenta un file ZIP e restituisce i relativi file di componenti. |
zip(blobs) | Blob | Crea un nuovo oggetto Blob, ovvero un file ZIP contenente i dati dei Blob trasmessi. |
zip(blobs, name) | Blob | Crea un nuovo oggetto Blob, ovvero un file ZIP contenente i dati dei Blob trasmessi. |
Documentazione dettagliata
base64Decode(encoded)
Decodifica una stringa con codifica Base64 in un array di byte 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
encoded | String | Un array di byte di dati da decodificare. |
Ritorni
Byte[]
: dati non elaborati rappresentati dall'argomento codificato in base 64 come array di byte.
base64Decode(encoded, charset)
Decodifica una stringa con codifica Base64 in una matrice di byte in un set di caratteri specifico.
// 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
encoded | String | La stringa di dati da decodificare. |
charset | Charset | Un Charset che specifica il set di caratteri dell'input. |
Ritorni
Byte[]
: dati non elaborati rappresentati dall'argomento codificato in base 64 come array di byte.
base64DecodeWebSafe(encoded)
Decodifica una stringa con codifica Base64 sicura per il web in un array di byte 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
encoded | String | Un array di byte di dati sicuri per il web da decodificare. |
Ritorni
Byte[]
: dati non elaborati rappresentati dall'argomento codificato per la sicurezza web in base 64 come array di byte.
base64DecodeWebSafe(encoded, charset)
Decodifica una stringa con codifica Base64 sicura per il web in un array di byte in un set di caratteri specifico.
// 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
encoded | String | La stringa di dati sicuri per il web da decodificare. |
charset | Charset | Un Charset che specifica il set di caratteri dell'input. |
Ritorni
Byte[]
: dati non elaborati rappresentati dall'argomento codificato per la sicurezza web in base 64 come array di byte.
base64Encode(data)
Genera una stringa con codifica in base 64 dall'array di byte specificato. La codifica Base 64 è una codifica comune accettata da vari strumenti che non accettano dati binari. La versione Base64 è comunemente utilizzata nei protocolli internet come email, HTTP o nei documenti 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | Byte[] | Un byte[] di dati da codificare. |
Ritorni
String
: la rappresentazione codificata in Base64 dei dati passati.
base64Encode(data)
Genera una stringa codificata in base-64 dalla stringa specificata. Base 64 è una codifica comune accettata da vari strumenti che non supportano dati binari. Base 64 è comunemente usato nei protocolli internet come email, HTTP o nei documenti XML.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64Encode("A string here"); Logger.log(encoded);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | String | La stringa da codificare. |
Ritorni
String
: la rappresentazione codificata in Base64 della stringa di input.
base64Encode(data, charset)
Genera una stringa codificata in base-64 dalla stringa specificata in un set di caratteri specifico. Un set di caratteri è un modo per codificare i caratteri. Vengono generalmente eseguite in un formato binario, generalmente incompatibile con determinati protocolli di trasmissione dati. Per rendere i dati compatibili, generalmente vengono codificati in base 64, una codifica comune accettata da una varietà di strumenti che non possono accettare dati binari. La versione Base64 è comunemente utilizzata nei protocolli internet come email, HTTP o nei documenti 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | String | La stringa di dati da codificare. |
charset | Charset | Un Charset che specifica il set di caratteri dell'input. |
Ritorni
String
: la rappresentazione codificata in Base64 della stringa di input con il valore Charset
specificato.
base64EncodeWebSafe(data)
Genera una stringa codificata sicura per il web in Base64 dall'array di byte specificato. Base 64 è una codifica comune accettata da una varietà di strumenti che non possono accettare dati binari. La sicurezza web Base64 è comunemente utilizzata nei protocolli internet come email, HTTP o nei documenti 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | Byte[] | Un array di byte di dati da codificare. |
Ritorni
String
: la rappresentazione con codifica Base64 e sicura per il web dei dati passati.
base64EncodeWebSafe(data)
Genera una stringa codificata in base-64 sicura per il web dalla stringa specificata. La codifica Base 64 è una codifica comune accettata da vari strumenti che non accettano dati binari. La sicurezza web Base 64 è comunemente utilizzata nei protocolli internet come email, HTTP o nei documenti XML.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64EncodeWebSafe("A string here"); Logger.log(encoded);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | String | La stringa da codificare. |
Ritorni
String
: la rappresentazione codificata in base 64 per il web della stringa di input.
base64EncodeWebSafe(data, charset)
Genera una stringa codificata con protezione web Base64 dalla stringa specificata in un set di caratteri specifico. Un set di caratteri è un modo per codificare i caratteri. Queste vengono generalmente eseguite in un formato binario, che generalmente non è compatibile con determinati protocolli di trasmissione dei dati. Per renderli compatibili, i dati sono generalmente codificati in base 64, una codifica comune accettata da una varietà di strumenti che non possono accettare dati binari. La sicurezza web Base 64 viene comunemente utilizzata nei protocolli internet come email, HTTP o nei documenti 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | String | La stringa di dati da codificare. |
charset | Charset | Un Charset che specifica il set di caratteri dell'input. |
Ritorni
String
: la rappresentazione codificata in Base64 per il Web della stringa di input con il valore Charset
specificato.
computeDigest(algorithm, value)
Calcola un digest utilizzando l'algoritmo specificato sul valore Byte[]
specificato.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash") var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input); Logger.log(digest);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
algorithm | DigestAlgorithm | Un DigestAlgorithm da utilizzare. |
value | Byte[] | Un valore stringa di input per il quale calcolare un digest. |
Ritorni
Byte[]
: un byte[] che rappresenta il digest di output.
computeDigest(algorithm, value)
Calcola un digest utilizzando l'algoritmo specificato sul valore String
specificato.
var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, "input to hash"); Logger.log(digest);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
algorithm | DigestAlgorithm | Un DigestAlgorithm da utilizzare. |
value | String | Un valore stringa di input per il quale calcolare un digest. |
Ritorni
Byte[]
: un byte[] che rappresenta il digest di output.
computeDigest(algorithm, value, charset)
Calcola un digest utilizzando l'algoritmo specificato sul valore String
specificato con il
set di caratteri specificato.
var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, "input to hash", Utilities.Charset.US_ASCII); Logger.log(digest);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
algorithm | DigestAlgorithm | Un DigestAlgorithm da utilizzare. |
value | String | Un valore stringa di input per il quale calcolare un digest. |
charset | Charset | Un Charset che rappresenta il set di caratteri di input. |
Ritorni
Byte[]
: un byte[] che rappresenta il digest di output.
computeHmacSha256Signature(value, key)
Firma il valore fornito utilizzando HMAC-SHA256 con la chiave specificata.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | Byte[] | Il valore di input per il quale generare un hash. |
key | Byte[] | Una chiave da utilizzare per generare l'hash. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeHmacSha256Signature(value, key)
Firma il valore fornito utilizzando HMAC-SHA256 con la chiave specificata.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave da utilizzare per generare l'hash. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeHmacSha256Signature(value, key, charset)
Firma il valore fornito utilizzando HMAC-SHA256 con la chiave e il set di caratteri specificati.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave da utilizzare per generare l'hash. |
charset | Charset | Un Charset che rappresenta il set di caratteri di input. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeHmacSignature(algorithm, value, key)
Calcola un codice di autenticazione dei messaggi utilizzando l'algoritmo specificato sulla chiave e sul valore specificati.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
algorithm | MacAlgorithm | Un algoritmo MacAlgorithm da utilizzare per eseguire l'hashing del valore di input. |
value | Byte[] | Il valore di input per il quale generare un hash. |
key | Byte[] | Una chiave da utilizzare per generare l'hash. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeHmacSignature(algorithm, value, key)
Calcola un codice di autenticazione dei messaggi utilizzando l'algoritmo specificato sulla chiave e sul valore specificati.
// This writes an array of bytes to the log. var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5, "input to hash", "key"); Logger.log(signature);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
algorithm | MacAlgorithm | Un algoritmo MacAlgorithm da utilizzare per eseguire l'hashing del valore di input. |
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave da utilizzare per generare l'hash. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeHmacSignature(algorithm, value, key, charset)
Calcola un codice di autenticazione dei messaggi utilizzando l'algoritmo specificato sulla chiave e sul valore specificati.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
algorithm | MacAlgorithm | Un algoritmo MacAlgorithm da utilizzare per eseguire l'hashing del valore di input. |
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave da utilizzare per generare l'hash. |
charset | Charset | Un Charset che rappresenta il set di caratteri di input. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeRsaSha1Signature(value, key)
Firma il valore fornito utilizzando RSA-SHA1 con la chiave specificata.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave in formato PEM da utilizzare per generare la firma. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeRsaSha1Signature(value, key, charset)
Firma il valore fornito utilizzando RSA-SHA1 con la chiave e il set di caratteri specificati.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave in formato PEM da utilizzare per generare la firma. |
charset | Charset | Un Charset che rappresenta il set di caratteri di input. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeRsaSha256Signature(value, key)
Firma il valore fornito utilizzando RSA-SHA256 con la chiave fornita.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave in formato PEM da utilizzare per generare la firma. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeRsaSha256Signature(value, key, charset)
Firma il valore fornito utilizzando RSA-SHA256 con la chiave fornita.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave in formato PEM da utilizzare per generare la firma. |
charset | Charset | Un Charset che rappresenta il set di caratteri di input. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeRsaSignature(algorithm, value, key)
Firma il valore fornito utilizzando l'algoritmo RSA specificato con la chiave specificata.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
algorithm | RsaAlgorithm | Un algoritmo RsaAlgorithm da utilizzare per eseguire l'hashing del valore di input. |
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave in formato PEM da utilizzare per generare la firma. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
computeRsaSignature(algorithm, value, key, charset)
Firma il valore fornito utilizzando l'algoritmo RSA specificato con la chiave e il set di caratteri specificati.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
algorithm | RsaAlgorithm | Un algoritmo RsaAlgorithm da utilizzare per eseguire l'hashing del valore di input. |
value | String | Il valore di input per il quale generare un hash. |
key | String | Una chiave in formato PEM da utilizzare per generare la firma. |
charset | Charset | Un Charset che rappresenta il set di caratteri di input. |
Ritorni
Byte[]
: un byte[] che rappresenta la firma di output.
formatDate(date, timeZone, format)
I formati variano in base alla specifica descritta nella classe SimpleDateFormat di Java SE. Consulta le specifiche all'indirizzo 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | Un Date da formattare come stringa. |
timeZone | String | Il fuso orario di output del risultato. |
format | String | Un formato conforme alla specifica SimpleDateFormat . |
Ritorni
String
: la data di input come stringa formattata.
formatString(template, args)
Esegue la formattazione di stringhe di tipo sprintf
utilizzando stringhe di formato di tipo "%".
// " 123.456000" Utilities.formatString('%11.6f', 123.456); // " abc" Utilities.formatString('%6s', 'abc');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
template | String | La stringa di formato che controlla cosa viene restituito. |
args | Object... | Oggetti da utilizzare per compilare i segnaposto "%" nel modello. |
Ritorni
String
: la stringa formattata.
getUuid()
Ottieni un UUID come stringa (equivalente all'utilizzo del metodo java.util.UUID.randomUUID()
). Non è garantito che questo identificatore sia
univoco nel tempo e nello spazio. Pertanto, non utilizzare in situazioni in cui è richiesta l'univocità garantita.
//This assigns a UUID as a temporary ID for a data object you are creating in your script. var myDataObject = { tempId: Utilities.getUuid(); };
Ritorni
String
: una rappresentazione stringa dell'UUID.
gzip(blob)
gzip
comprime i dati Blob
forniti e li restituisce in un nuovo oggetto Blob
.
var textBlob = Utilities.newBlob("Some text to compress using gzip compression"); // Create the compressed blob. var gzipBlob = Utilities.gzip(textBlob);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blob | BlobSource | Un oggetto Blob da comprimere utilizzando gzip . |
Ritorni
gzip(blob, name)
gzip
comprime i dati Blob
forniti e li restituisce in un nuovo oggetto Blob
. Questa versione del metodo consente di specificare un nome file.
var textBlob = Utilities.newBlob("Some text to compress using gzip compression"); // Create the compressed blob. var gzipBlob = Utilities.gzip(textBlob, "text.gz");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blob | BlobSource | Un oggetto Blob da comprimere utilizzando gzip . |
name | String | Il nome del file gzip da creare. |
Ritorni
newBlob(data)
Crea un nuovo oggetto Blob da un array di byte. I BLOB vengono utilizzati in molte API Apps Script che prendono dati binari come input.
// 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | Byte[] | I byte del blob. |
Ritorni
Blob
: il blob appena creato.
newBlob(data, contentType)
Crea un nuovo oggetto Blob da un array di byte e da un tipo di contenuto. I blob sono usati in molte API Apps Script che prendono i dati binari come input.
// 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | Byte[] | I byte del blob. |
contentType | String | Il tipo di contenuti del blob. Può essere null . |
Ritorni
Blob
: il blob appena creato.
newBlob(data, contentType, name)
Crea un nuovo oggetto Blob da un array di byte, un tipo di contenuto e un nome. I BLOB vengono utilizzati in molte API Apps Script che ricevono dati binari come input.
// 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | Byte[] | I byte del blob. |
contentType | String | - Il tipo di contenuti del BLOB. Può essere null . |
name | String | Il nome del blob può essere null . |
Ritorni
Blob
: il blob appena creato.
newBlob(data)
Crea un nuovo oggetto Blob da una stringa. I BLOB vengono utilizzati in molte API Apps Script che prendono dati binari come input.
// 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | String | La stringa del blob, utilizzata come UTF-8. |
Ritorni
Blob
: il blob appena creato.
newBlob(data, contentType)
Crea un nuovo oggetto Blob da una stringa e da un tipo di contenuti. I blob sono usati in molte API Apps Script che prendono i dati binari come input.
// 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | String | La stringa del blob, utilizzata come UTF-8. |
contentType | String | Il tipo di contenuti del blob. Può essere null . |
Ritorni
Blob
: il blob appena creato.
newBlob(data, contentType, name)
Crea un nuovo oggetto Blob da una stringa, un tipo di contenuti e un nome. I BLOB vengono utilizzati in molte API Apps Script che ricevono dati binari come input.
// 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | String | La stringa del blob, utilizzata come UTF-8. |
contentType | String | Il tipo di contenuti del blob. Può essere null . |
name | String | Il nome del blob può essere null . |
Ritorni
Blob
: il blob appena creato.
parseCsv(csv)
Restituisce una rappresentazione array 2D tabulare di una stringa 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
csv | String | Una stringa contenente dati singoli o multilinea in formato CSV (valori separati da virgole). |
Ritorni
String[][]
: array bidimensionale contenente i valori nella stringa CSV.
parseCsv(csv, delimiter)
Restituisce una rappresentazione array 2D tabulare di una stringa CSV utilizzando un delimitatore personalizzato.
// 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');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
csv | String | Una stringa contenente dati singoli o multilinea in formato CSV (valori separati da virgole). |
delimiter | Char | Tra i valori. |
Ritorni
String[][]
: array bidimensionale contenente i valori nella stringa CSV.
parseDate(date, timeZone, format)
Analizza la data della stringa fornita in base alla specifica descritta nella classe SimpleDateFormat
di Java Standard Edition. Per ulteriori informazioni, consulta la classe SimpleDateFormat
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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | String | Un valore stringa da analizzare come data. |
timeZone | String | Il fuso orario di output. |
format | String | Il formato della data in base alla specifica SimpleDateFormat . |
Ritorni
Date
: la stringa di input come data.
sleep(milliseconds)
Sonno per il numero specificato di millisecondi. Mette immediatamente in sospensione lo script per il numero specificato di millisecondi. Il valore massimo consentito è 300.000 (o 5 minuti).
// 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());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
milliseconds | Integer | Il numero di millisecondi di sospensione. |
ungzip(blob)
Decomprime un oggetto Blob
e restituisce un Blob
contenente i dati non compressi.
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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blob | BlobSource | Blob di dati compressi. |
Ritorni
unzip(blob)
Recupera un BLOB che rappresenta un file ZIP e restituisce i relativi file di componenti.
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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blob | BlobSource | Il blob del file ZIP. |
Ritorni
Blob[]
: un Blob[] che rappresenta i blob dei componenti, ciascuno denominato con il percorso completo all'interno del file ZIP.
zip(blobs)
Crea un nuovo oggetto Blob, ovvero un file ZIP contenente i dati dei Blob trasmessi.
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]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobs | BlobSource[] | Un array di blob da comprimere. |
Ritorni
Blob
: un nuovo blob contenente gli input come archivio.
zip(blobs, name)
Crea un nuovo oggetto Blob, ovvero un file ZIP contenente i dati dei Blob trasmessi. Questa versione del metodo consente di specificare un nome file.
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");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
blobs | BlobSource[] | Un array di blob da comprimere. |
name | String | Il nome del file ZIP da creare. |
Ritorni
Blob
: un nuovo blob contenente gli input come archivio.