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 | |
Digest | Digest | |
Mac | Mac | |
Rsa | Rsa |
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. |
compute | Byte[] | Calcola un digest utilizzando l'algoritmo specificato sul valore Byte[] specificato. |
compute | Byte[] | Calcola un digest utilizzando l'algoritmo specificato sul valore String specificato. |
compute | Byte[] | Calcola un digest utilizzando l'algoritmo specificato sul valore String specificato con il set di caratteri specificato. |
compute | Byte[] | Firma il valore fornito utilizzando HMAC-SHA256 con la chiave specificata. |
compute | Byte[] | Firma il valore fornito utilizzando HMAC-SHA256 con la chiave specificata. |
compute | Byte[] | Firma il valore fornito utilizzando HMAC-SHA256 con la chiave e il set di caratteri specificati. |
compute | Byte[] | Calcola un codice di autenticazione dei messaggi utilizzando l'algoritmo specificato sulla chiave e sul valore specificati. |
compute | Byte[] | Calcola un codice di autenticazione dei messaggi utilizzando l'algoritmo specificato sulla chiave e sul valore specificati. |
compute | Byte[] | Calcola un codice di autenticazione dei messaggi utilizzando l'algoritmo specificato sulla chiave e sul valore specificati. |
compute | Byte[] | Firma il valore fornito utilizzando RSA-SHA1 con la chiave specificata. |
compute | Byte[] | Firma il valore fornito utilizzando RSA-SHA1 con la chiave e il set di caratteri specificati. |
compute | Byte[] | Firma il valore fornito utilizzando RSA-SHA256 con la chiave specificata. |
compute | Byte[] | Firma il valore fornito utilizzando RSA-SHA256 con la chiave specificata. |
compute | Byte[] | Firma il valore fornito utilizzando l'algoritmo RSA specificato con la chiave indicata. |
compute | Byte[] | Firma il valore fornito utilizzando l'algoritmo RSA specificato con la chiave e il set di caratteri specificati. |
format | String | Formatta la data in base alle specifiche descritte nella classe SimpleDateFormat di Java SE. |
format | String | Esegue la formattazione di stringhe simili a sprintf utilizzando stringhe di formato in stile "%". |
get | 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 . |
new | Blob | Crea un nuovo oggetto Blob da un array di byte. |
new | Blob | Crea un nuovo oggetto Blob da un array di byte e un tipo di contenuto. |
new | Blob | Crea un nuovo oggetto Blob da un array di byte, un tipo di contenuto e un nome. |
new | Blob | Crea un nuovo oggetto Blob da una stringa. |
new | Blob | Crea un nuovo oggetto Blob da una stringa e un tipo di contenuto. |
new | Blob | Crea un nuovo oggetto Blob da una stringa, un tipo di contenuto e un nome. |
parse | String[][] | Restituisce una rappresentazione tabulare di un array 2D di una stringa CSV. |
parse | String[][] | Restituisce una rappresentazione di array 2D tabulare di una stringa CSV utilizzando un delimitatore personalizzato. |
parse | Date | Analizza la data della stringa fornita in base alla specifica descritta nella classe Java Standard Edition Simple . |
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. |
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.
compute Digest(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 | Digest | Un Digest 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.
compute Digest(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 | Digest | Un Digest 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.
compute Digest(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 | Digest | Un Digest 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.
compute Hmac Sha256Signature(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.
compute Hmac Sha256Signature(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 in uscita.
compute Hmac Sha256Signature(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.
compute Hmac Signature(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 | Mac | Un algoritmo Mac 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.
compute Hmac Signature(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 | Mac | Un algoritmo Mac 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.
compute Hmac Signature(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 | Mac | Un algoritmo Mac 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 in uscita.
compute Rsa Sha1Signature(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.
compute Rsa Sha1Signature(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 in uscita.
compute Rsa Sha256Signature(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 in uscita.
compute Rsa Sha256Signature(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.
compute Rsa Signature(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 | Rsa | Un algoritmo Rsa 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 in uscita.
compute Rsa Signature(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 | Rsa | Un algoritmo Rsa 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.
format Date(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. |
time | String | Il fuso orario di output del risultato. |
format | String | Un formato conforme alla specifica Simple . |
Invio
String
: la data inserita come stringa formattata.
format String(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.
get Uuid()
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 | Blob | Un oggetto Blob da comprimere utilizzando gzip . |
Invio
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 | Blob | Un oggetto Blob da comprimere utilizzando gzip . |
name | String | Il nome del file gzip da creare. |
Invio
new Blob(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.
new Blob(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. |
content | String | Il tipo di contenuti del blob, che può essere null . |
Invio
Blob
: il blob appena creato.
new Blob(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. |
content | 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.
new Blob(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.
new Blob(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. |
content | String | Il tipo di contenuti del blob, che può essere null . |
Invio
Blob
: il blob appena creato.
new Blob(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. |
content | 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.
parse Csv(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.
parse Csv(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.
parse Date(date, timeZone, format)
Analizza la data della stringa fornita in base alla specifica descritta nella classe Java Standard Edition Simple
. Per ulteriori informazioni, consulta la classe Simple
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. |
time | String | Il fuso orario di output. |
format | String | Il formato della data secondo la specifica Simple . |
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 | Blob | Il Blob dei dati compressi. |
Invio
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 | Blob | 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 | Blob | 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 | Blob | 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.