Questa pagina è stata tradotta dall'API Cloud Translation.

Class Utilities

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.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
`jsonParse(jsonString)`	`Object`	Restituisce un oggetto corrispondente alla stringa JSON trasmessa.
`jsonStringify(obj)`	`String`	Restituisce una stringa JSON dell'oggetto trasmesso.

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

Blob: un nuovo elemento Blob contenente i dati compressi.

`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

Blob: un nuovo elemento Blob contenente i dati compressi.

`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

Blob: un Blob che rappresenta i dati decompressi.

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

Metodi deprecati

`jsonParse(jsonString)`

Obsoleta. A partire da novembre 2013, sostituito da JSON.parse()

Restituisce un oggetto corrispondente alla stringa JSON trasmessa.

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

Parametri

Nome	Tipo	Descrizione
`jsonString`	`String`	Una rappresentazione stringa di un oggetto JavaScript da deserializzare.

Ritorni

Object: una rappresentazione oggetto JavaScript dell'input.

`jsonStringify(obj)`

Obsoleta. A partire da novembre 2013, sostituito da JSON.stringify()

Restituisce una stringa JSON dell'oggetto trasmesso.

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

Parametri

Nome	Tipo	Descrizione
`obj`	`Object`	l'oggetto JavaScript da serializzare in JSON

Ritorni

String: un oggetto JavaScript serializzato JSON