Questa pagina è stata tradotta dall'API Cloud Translation.

Class Utilities

Questo servizio fornisce utilità per la codifica/decodifica di stringhe, la formattazione delle date, la manipolazione di 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 un array di byte in un set di caratteri specifico.
`base64DecodeWebSafe(encoded)`	`Byte[]`	Decodifica una stringa codificata in base 64 sicura per il web in un array di byte UTF-8.
`base64DecodeWebSafe(encoded, charset)`	`Byte[]`	Decodifica una stringa con codifica sicura per il web base 64 in un array di byte in un set di caratteri specifico.
`base64Encode(data)`	`String`	Genera una stringa con codifica base-64 dall'array di byte specificato.
`base64Encode(data)`	`String`	Genera una stringa con codifica 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 con codifica Base64 sicura per il web dall'array di byte specificato.
`base64EncodeWebSafe(data)`	`String`	Genera una stringa con codifica Base64 sicura per il web dalla stringa specificata.
`base64EncodeWebSafe(data, charset)`	`String`	Genera una stringa codificata in base 64 sicura per il web 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 specificata.
`computeRsaSha256Signature(value, key, charset)`	`Byte[]`	Firma il valore fornito utilizzando RSA-SHA256 con la chiave specificata.
`computeRsaSignature(algorithm, value, key)`	`Byte[]`	Firma il valore fornito utilizzando l'algoritmo RSA specificato con la chiave indicata.
`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`	Formatta la data in base alle specifiche descritte nella classe SimpleDateFormat di Java SE.
`formatString(template, args)`	`String`	Esegue la formattazione di stringhe simili a `sprintf` utilizzando stringhe di formato in stile "%".
`getUuid()`	`String`	Recupera 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 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 un tipo di contenuto.
`newBlob(data, contentType, name)`	`Blob`	Crea un nuovo oggetto Blob da una stringa, un tipo di contenuto e un nome.
`parseCsv(csv)`	`String[][]`	Restituisce una rappresentazione tabulare di un array 2D di una stringa CSV.
`parseCsv(csv, delimiter)`	`String[][]`	Restituisce una rappresentazione di 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 Java Standard Edition `SimpleDateFormat`.
`sleep(milliseconds)`	`void`	Mette in pausa l'esecuzione per il numero di millisecondi specificato.
`ungzip(blob)`	`Blob`	Decomprime un oggetto `Blob` e restituisce un `Blob` contenente i dati non compressi.
`unzip(blob)`	`Blob[]`	Prende un blob che rappresenta un file ZIP e restituisce i file componenti.
`zip(blobs)`	`Blob`	Crea un nuovo oggetto Blob che è un file ZIP contenente i dati dei blob passati.
`zip(blobs, name)`	`Blob`	Crea un nuovo oggetto Blob che è un file ZIP contenente i dati dei blob passati.

Metodi ritirati

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

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

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
const decoded = Utilities.base64Decode(base64data);
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parametri

Nome	Tipo	Descrizione
`encoded`	`String`	Un array di byte di dati da decodificare.

Invio

Byte[]: i dati non elaborati rappresentati dall'argomento con codifica base64 come array di byte.

`base64Decode(encoded, charset)`

Decodifica una stringa con codifica base64 in un array di byte in un set di caratteri specifico.

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

const decoded = Utilities.base64Decode(base64data, Utilities.Charset.UTF_8);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parametri

Nome	Tipo	Descrizione
`encoded`	`String`	La stringa di dati da decodificare.
`charset`	`Charset`	Un `Charset` che specifica il set di caratteri dell'input.

Invio

Byte[]: i dati non elaborati rappresentati dall'argomento con codifica base64 come array di byte.

`base64DecodeWebSafe(encoded)`

Decodifica una stringa codificata in base 64 sicura per il web in un array di byte UTF-8.

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

const decoded = Utilities.base64DecodeWebSafe(base64data);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parametri

Nome	Tipo	Descrizione
`encoded`	`String`	Un array di byte di dati sicuri per il web da decodificare.

Invio

Byte[]: i dati non elaborati rappresentati dall'argomento con codifica Base64 sicura per il web come array di byte.

`base64DecodeWebSafe(encoded, charset)`

Decodifica una stringa con codifica sicura per il web base 64 in un array di byte in un set di caratteri specifico.

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

const decoded = Utilities.base64DecodeWebSafe(
    base64data,
    Utilities.Charset.UTF_8,
);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

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.

Invio

Byte[]: i dati non elaborati rappresentati dall'argomento con codifica Base64 sicura per il web come array di byte.

`base64Encode(data)`

Genera una stringa con codifica base-64 dall'array di byte specificato. Base 64 è una codifica comune accettata da una serie di strumenti che non possono accettare dati binari. La base 64 viene utilizzata comunemente nei protocolli internet come email, HTTP o nei documenti XML.

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

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64Encode(blob.getBytes());
Logger.log(encoded);

Parametri

Nome	Tipo	Descrizione
`data`	`Byte[]`	Un byte[] di dati da codificare.

Invio

String: la rappresentazione con codifica Base64 dei dati passati.

`base64Encode(data)`

Genera una stringa con codifica base-64 dalla stringa specificata. Base 64 è una codifica comune accettata da una serie di strumenti che non possono accettare dati binari. La base 64 è comunemente utilizzata nei protocolli internet come email, HTTP o in documenti XML.

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

Parametri

Nome	Tipo	Descrizione
`data`	`String`	La stringa da codificare.

Invio

String: la rappresentazione codificata in base-64 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 in modo che possano essere codificati. In genere vengono eseguiti in un formato binario, che in genere può essere incompatibile con determinati protocolli di trasmissione dei dati. Per rendere i dati compatibili, in genere vengono codificati in base 64, che è una codifica comune accettata da una serie di strumenti che non possono accettare dati binari. La base 64 viene utilizzata comunemente nei protocolli internet come email, HTTP o nei documenti XML.

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

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
const encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

Parametri

Nome	Tipo	Descrizione
`data`	`String`	La stringa di dati da codificare.
`charset`	`Charset`	Un `Charset` che specifica il set di caratteri dell'input.

Invio

String: la rappresentazione con codifica base64 della stringa di input con il Charset specificato.

`base64EncodeWebSafe(data)`

Genera una stringa con codifica Base64 sicura per il web dall'array di byte specificato. Base 64 è una codifica comune accettata da una serie di strumenti che non possono accettare dati binari. La codifica Base 64 sicura per il web viene spesso utilizzata nei protocolli internet come email, HTTP o nei documenti XML.

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

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64EncodeWebSafe(blob.getBytes());
Logger.log(encoded);

Parametri

Nome	Tipo	Descrizione
`data`	`Byte[]`	Un array di byte di dati da codificare.

Invio

String: la rappresentazione codificata Base64 sicura per il web dei dati passati.

`base64EncodeWebSafe(data)`

Genera una stringa con codifica Base64 sicura per il web dalla stringa specificata. Base 64 è una codifica comune accettata da una serie di strumenti che non possono accettare dati binari. La codifica Base 64 sicura per il web viene comunemente utilizzata nei protocolli internet come email, HTTP o nei documenti XML.

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

Parametri

Nome	Tipo	Descrizione
`data`	`String`	La stringa da codificare.

Invio

String: la rappresentazione con codifica Base64 sicura per il web della stringa di input.

`base64EncodeWebSafe(data, charset)`

Genera una stringa codificata in base 64 sicura per il web dalla stringa specificata in un set di caratteri specifico. Un set di caratteri è un modo per codificare i caratteri in modo che possano essere codificati. In genere vengono eseguiti in un formato binario, che in genere può essere incompatibile con determinati protocolli di trasmissione dei dati. Per renderli compatibili, i dati vengono generalmente codificati in base 64, che è una codifica comune accettata da una serie di strumenti che non possono accettare dati binari. La codifica Base 64 sicura per il web viene comunemente utilizzata nei protocolli internet come email, HTTP o nei documenti XML.

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

// Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log
const encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

Parametri

Nome	Tipo	Descrizione
`data`	`String`	La stringa di dati da codificare.
`charset`	`Charset`	Un `Charset` che specifica il set di caratteri dell'input.

Invio

String: la rappresentazione codificata in base 64 sicura per il web della stringa di input con il Charset specificato.

`computeDigest(algorithm, value)`

Calcola un digest utilizzando l'algoritmo specificato sul valore Byte[] specificato.

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

Parametri

Nome	Tipo	Descrizione
`algorithm`	`DigestAlgorithm`	Un `DigestAlgorithm` da utilizzare.
`value`	`Byte[]`	Un valore di stringa di input per il quale calcolare un digest.

Invio

Byte[]: un byte[] che rappresenta il digest di output.

`computeDigest(algorithm, value)`

Calcola un digest utilizzando l'algoritmo specificato sul valore String specificato.

const 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 di stringa di input per il quale calcolare un digest.

Invio

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.

const 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 di stringa di input per il quale calcolare un digest.
`charset`	`Charset`	Un `Charset` che rappresenta il set di caratteri di input.

Invio

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.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSha256Signature(input, key);
Logger.log(signature);

Parametri

Nome	Tipo	Descrizione
`value`	`Byte[]`	Il valore di input per cui generare un hash.
`key`	`Byte[]`	Una chiave da utilizzare per generare l'hash.

Invio

Byte[]: un byte[] che rappresenta la firma in uscita.

`computeHmacSha256Signature(value, key)`

Firma il valore fornito utilizzando HMAC-SHA256 con la chiave specificata.

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

Parametri

Nome	Tipo	Descrizione
`value`	`String`	Il valore di input per cui generare un hash.
`key`	`String`	Una chiave da utilizzare per generare l'hash.

Invio

Byte[]: un byte[] che rappresenta la firma dell'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.
const 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 cui 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.

Invio

Byte[]: un byte[] che rappresenta la firma in uscita.

`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.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    input,
    key,
);
Logger.log(signature);

Parametri

Nome	Tipo	Descrizione
`algorithm`	`MacAlgorithm`	Un algoritmo `MacAlgorithm` da utilizzare per sottoporre ad hashing il valore di input.
`value`	`Byte[]`	Il valore di input per cui generare un hash.
`key`	`Byte[]`	Una chiave da utilizzare per generare l'hash.

Invio

Byte[]: un byte[] che rappresenta la firma in uscita.

`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.
const 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 sottoporre ad hashing il valore di input.
`value`	`String`	Il valore di input per cui generare un hash.
`key`	`String`	Una chiave da utilizzare per generare l'hash.

Invio

Byte[]: un byte[] che rappresenta la firma in uscita.

`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.
const 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 sottoporre ad hashing il valore di input.
`value`	`String`	Il valore di input per cui 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.

Invio

Byte[]: un byte[] che rappresenta la firma dell'output.

`computeRsaSha1Signature(value, key)`

Firma il valore fornito utilizzando RSA-SHA1 con la chiave specificata.

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

Parametri

Nome	Tipo	Descrizione
`value`	`String`	Il valore di input per cui generare un hash.
`key`	`String`	Una chiave in formato PEM da utilizzare per generare la firma.

Invio

Byte[]: un byte[] che rappresenta la firma in uscita.

`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.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

Parametri

Nome	Tipo	Descrizione
`value`	`String`	Il valore di input per cui 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.

Invio

Byte[]: un byte[] che rappresenta la firma dell'output.

`computeRsaSha256Signature(value, key)`

Firma il valore fornito utilizzando RSA-SHA256 con la chiave specificata.

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

Parametri

Nome	Tipo	Descrizione
`value`	`String`	Il valore di input per cui generare un hash.
`key`	`String`	Una chiave in formato PEM da utilizzare per generare la firma.

Invio

Byte[]: un byte[] che rappresenta la firma dell'output.

`computeRsaSha256Signature(value, key, charset)`

Firma il valore fornito utilizzando RSA-SHA256 con la chiave specificata.

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

Parametri

Nome	Tipo	Descrizione
`value`	`String`	Il valore di input per cui 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.

Invio

Byte[]: un byte[] che rappresenta la firma in uscita.

`computeRsaSignature(algorithm, value, key)`

Firma il valore fornito utilizzando l'algoritmo RSA specificato con la chiave indicata.

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

Parametri

Nome	Tipo	Descrizione
`algorithm`	`RsaAlgorithm`	Un algoritmo `RsaAlgorithm` da utilizzare per sottoporre ad hashing il valore di input.
`value`	`String`	Il valore di input per cui generare un hash.
`key`	`String`	Una chiave in formato PEM da utilizzare per generare la firma.

Invio

Byte[]: un byte[] che rappresenta la firma dell'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.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

Parametri

Nome	Tipo	Descrizione
`algorithm`	`RsaAlgorithm`	Un algoritmo `RsaAlgorithm` da utilizzare per sottoporre ad hashing il valore di input.
`value`	`String`	Il valore di input per cui 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.

Invio

Byte[]: un byte[] che rappresenta la firma in uscita.

`formatDate(date, timeZone, format)`

Formatta la data in base alle specifiche descritte nella classe SimpleDateFormat di Java SE. Visita la pagina della specifica 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.
const 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`.

Invio

String: la data inserita come stringa formattata.

`formatString(template, args)`

Esegue la formattazione di stringhe simili a sprintf utilizzando stringhe di formato in stile "%".

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

Invio

String: la stringa formattata.

`getUuid()`

Recupera un UUID come stringa (equivalente all'utilizzo del metodo java.util.UUID.randomUUID()). Non è garantito che questo identificatore sia univoco in tutti i tempi e gli spazi. Di conseguenza, non utilizzarlo in situazioni in cui è richiesta un'unicità garantita.

// This assigns a UUID as a temporary ID for a data object you are creating in
// your script.
const myDataObject = {
  tempId: Utilities.getUuid(),
};

Invio

String: una rappresentazione stringa dell'UUID.

`gzip(blob)`

gzip-comprime i dati Blob forniti e li restituisce in un nuovo oggetto Blob.

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

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

Parametri

Nome	Tipo	Descrizione
`blob`	`BlobSource`	Un oggetto `Blob` da comprimere utilizzando `gzip`.

Invio

Blob: un nuovo 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.

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

// Create the compressed blob.
const 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.

Invio

Blob: un nuovo Blob contenente i dati compressi.

`newBlob(data)`

Crea un nuovo oggetto Blob da un array di byte. I blob vengono utilizzati in molte API di Apps Script che accettano come input dati binari.

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

Invio

Blob: il blob appena creato.

`newBlob(data, contentType)`

Crea un nuovo oggetto Blob da un array di byte e un tipo di contenuto. I blob vengono utilizzati in molte API di Apps Script che accettano 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, che può essere `null`.

Invio

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 accettano 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, che può essere `null`.
`name`	`String`	Il nome del blob, che può essere `null`.

Invio

Blob: il blob appena creato.

`newBlob(data)`

Crea un nuovo oggetto Blob da una stringa. I blob vengono utilizzati in molte API di Apps Script che accettano come input dati binari.

// 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 per il blob, intesa come UTF-8.

Invio

Blob: il blob appena creato.

`newBlob(data, contentType)`

Crea un nuovo oggetto Blob da una stringa e un tipo di contenuto. I blob vengono utilizzati in molte API di Apps Script che accettano 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 per il blob, intesa come UTF-8.
`contentType`	`String`	Il tipo di contenuti del blob, che può essere `null`.

Invio

Blob: il blob appena creato.

`newBlob(data, contentType, name)`

Crea un nuovo oggetto Blob da una stringa, un tipo di contenuto e un nome. I blob vengono utilizzati in molte API Apps Script che accettano 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 per il blob, intesa come UTF-8.
`contentType`	`String`	Il tipo di contenuti del blob, che può essere `null`.
`name`	`String`	Il nome del blob, che può essere `null`.

Invio

Blob: il blob appena creato.

`parseCsv(csv)`

Restituisce una rappresentazione tabulare di un array 2D di una stringa CSV.

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

Parametri

Nome	Tipo	Descrizione
`csv`	`String`	Una stringa contenente dati singoli o multipli in formato CSV (valori separati da virgola).

Invio

String[][]: un array bidimensionale contenente i valori nella stringa CSV.

`parseCsv(csv, delimiter)`

Restituisce una rappresentazione di 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]]
const csvString = 'a\tb\tc\nd\te\tf';
const data = Utilities.parseCsv(csvString, '\t');

Parametri

Nome	Tipo	Descrizione
`csv`	`String`	Una stringa contenente dati singoli o multipli in formato CSV (valori separati da virgola).
`delimiter`	`Char`	Tra valori.

Invio

String[][]: un 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 Java Standard Edition SimpleDateFormat. Per ulteriori informazioni, consulta la classe SimpleDateFormat di Java.

// This set of parameters parses the given string as a date in Greenwich Mean
// Time, formatted as year-month-dateThour-minute-second.
const date = Utilities.parseDate(
    '1970-01-01 00:00:00',
    'GMT',
    'yyyy-MM-dd\' \'HH:mm:ss',
);
Logger.log(date);

Parametri

Nome	Tipo	Descrizione
`date`	`String`	Un valore di stringa da analizzare come data.
`timeZone`	`String`	Il fuso orario di output.
`format`	`String`	Il formato della data secondo la specifica `SimpleDateFormat`.

Invio

Date: la stringa di input come data.

`sleep(milliseconds)`

Mette in pausa l'esecuzione per il numero di millisecondi specificato. Mette immediatamente in sospensione lo script per il numero di millisecondi specificato. Il valore massimo consentito è 300000 (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.

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

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

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

Parametri

Nome	Tipo	Descrizione
`blob`	`BlobSource`	Il `Blob` dei dati compressi.

Invio

Blob: un Blob che rappresenta i dati decompressi.

`unzip(blob)`

Prende un blob che rappresenta un file ZIP e restituisce i file componenti.

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

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

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

// This now unzips the blobs
const files = Utilities.unzip(zip);

Parametri

Nome	Tipo	Descrizione
`blob`	`BlobSource`	Il blob del file ZIP.

Invio

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 che è un file ZIP contenente i dati dei blob passati.

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

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

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

Parametri

Nome	Tipo	Descrizione
`blobs`	`BlobSource[]`	Un array di blob da comprimere.

Invio

Blob: un nuovo blob contenente gli input come archivio.

`zip(blobs, name)`

Crea un nuovo oggetto Blob che è un file ZIP contenente i dati dei blob passati. Questa versione del metodo consente di specificare un nome file.

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

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

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

Parametri

Nome	Tipo	Descrizione
`blobs`	`BlobSource[]`	Un array di blob da comprimere.
`name`	`String`	Il nome del file ZIP da creare.

Invio

Blob: un nuovo blob contenente gli input come archivio.

Metodi ritirati

`jsonParse(jsonString)`

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

Restituisce un oggetto corrispondente alla stringa JSON passata.

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

Parametri

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

Invio

Object: una rappresentazione dell'input sotto forma di oggetto JavaScript.

`jsonStringify(obj)`

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

Restituisce una stringa JSON dell'oggetto passato.

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

Parametri

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

Invio

String: un oggetto JavaScript serializzato in JSON