Class Utilities

Entreprises de services publics

Ce service fournit des utilitaires pour l'encodage/le décodage des chaînes, la mise en forme des dates, la manipulation JSON et d'autres tâches diverses.

Propriétés

PropriétéTypeDescription
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

Méthodes

MéthodeType renvoyéBrève description
base64Decode(encoded)Byte[]Décode une chaîne encodée en base64 en un tableau d'octets UTF-8.
base64Decode(encoded, charset)Byte[]Décode une chaîne encodée en base64 en tableau d'octets dans un jeu de caractères spécifique.
base64DecodeWebSafe(encoded)Byte[]Décode une chaîne encodée en base64 adaptée au Web en un tableau d'octets UTF-8.
base64DecodeWebSafe(encoded, charset)Byte[]Décode une chaîne encodée en base64 Web sécurisée en un tableau d'octets dans un jeu de caractères spécifique.
base64Encode(data)StringGénère une chaîne encodée en base64 à partir du tableau d'octets donné.
base64Encode(data)StringGénère une chaîne encodée en base64 à partir de la chaîne donnée.
base64Encode(data, charset)StringGénère une chaîne encodée en base64 à partir de la chaîne donnée dans un jeu de caractères spécifique.
base64EncodeWebSafe(data)StringGénère une chaîne encodée en base64 adaptée au Web à partir du tableau d'octets donné.
base64EncodeWebSafe(data)StringGénère une chaîne encodée en base64 adaptée au Web à partir de la chaîne donnée.
base64EncodeWebSafe(data, charset)StringGénère une chaîne encodée en base64 adaptée au Web à partir de la chaîne donnée dans un jeu de caractères spécifique.
computeDigest(algorithm, value)Byte[]Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur Byte[] spécifiée.
computeDigest(algorithm, value)Byte[]Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur String spécifiée.
computeDigest(algorithm, value, charset)Byte[]Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur String spécifiée avec le jeu de caractères indiqué.
computeHmacSha256Signature(value, key)Byte[]Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé donnée.
computeHmacSha256Signature(value, key)Byte[]Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé donnée.
computeHmacSha256Signature(value, key, charset)Byte[]Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé et le jeu de caractères donnés.
computeHmacSignature(algorithm, value, key)Byte[]Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées.
computeHmacSignature(algorithm, value, key)Byte[]Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées.
computeHmacSignature(algorithm, value, key, charset)Byte[]Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées.
computeRsaSha1Signature(value, key)Byte[]Signe la valeur fournie à l'aide de RSA-SHA1 avec la clé donnée.
computeRsaSha1Signature(value, key, charset)Byte[]Signe la valeur fournie à l'aide de RSA-SHA1 avec la clé et le jeu de caractères donnés.
computeRsaSha256Signature(value, key)Byte[]Signe la valeur fournie à l'aide de RSA-SHA256 avec la clé donnée.
computeRsaSha256Signature(value, key, charset)Byte[]Signe la valeur fournie à l'aide de RSA-SHA256 avec la clé donnée.
computeRsaSignature(algorithm, value, key)Byte[]Signe la valeur fournie à l'aide de l'algorithme RSA spécifié avec la clé donnée.
computeRsaSignature(algorithm, value, key, charset)Byte[]Signe la valeur fournie à l'aide de l'algorithme RSA spécifié avec la clé et le jeu de caractères donnés.
formatDate(date, timeZone, format)StringMet en forme les dates conformément à la spécification décrite dans la classe Java SE SimpleDateFormat.
formatString(template, args)StringEffectue une mise en forme de chaîne de type sprintf à l'aide de chaînes de format "%".
getUuid()StringObtenez un UUID sous forme de chaîne (cela équivaut à l'utilisation de la méthode java.util.UUID.randomUUID()).
gzip(blob)Blobgzip compresse les données Blob fournies et les renvoie dans un nouvel objet Blob.
gzip(blob, name)Blobgzip compresse les données Blob fournies et les renvoie dans un nouvel objet Blob.
newBlob(data)BlobCrée un objet Blob à partir d'un tableau d'octets.
newBlob(data, contentType)BlobCrée un objet Blob à partir d'un tableau d'octets et d'un type de contenu.
newBlob(data, contentType, name)BlobCréez un objet Blob à partir d'un tableau d'octets, d'un type de contenu et d'un nom.
newBlob(data)BlobCrée un objet Blob à partir d'une chaîne.
newBlob(data, contentType)BlobCréez un objet Blob à partir d'une chaîne et d'un type de contenu.
newBlob(data, contentType, name)BlobCréez un objet Blob à partir d'une chaîne, d'un type de contenu et d'un nom.
parseCsv(csv)String[][]Renvoie la représentation sous forme de tableau 2D d'une chaîne CSV sous forme de tableau 2D.
parseCsv(csv, delimiter)String[][]Renvoie une représentation sous forme de tableau 2D tabulaire d'une chaîne CSV à l'aide d'un délimiteur personnalisé.
parseDate(date, timeZone, format)DateAnalyse la date de chaîne fournie selon la spécification décrite dans la classe SimpleDateFormat de l'édition Java standard.
sleep(milliseconds)voidMise en veille pendant le nombre de millisecondes spécifié.
ungzip(blob)BlobDécompresse un objet Blob et renvoie un Blob contenant les données non compressées.
unzip(blob)Blob[]Prend un objet Blob représentant un fichier ZIP et renvoie ses fichiers composant.
zip(blobs)BlobCrée un objet Blob qui est un fichier ZIP contenant les données des objets Blob transmis.
zip(blobs, name)BlobCrée un objet Blob qui est un fichier ZIP contenant les données des objets Blob transmis.

Documentation détaillée

base64Decode(encoded)

Décode une chaîne encodée en base64 en un tableau d'octets 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());

Paramètres

NomTypeDescription
encodedStringTableau d'octets de données à décoder.

Renvois

Byte[] : données brutes représentées par l'argument encodé en base64 sous la forme d'un tableau d'octets.


base64Decode(encoded, charset)

Décode une chaîne encodée en base64 en tableau d'octets dans un jeu de caractères spécifique.

// 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());

Paramètres

NomTypeDescription
encodedStringChaîne de données à décoder.
charsetCharsetUne valeur Charset spécifiant le jeu de caractères de l'entrée.

Renvois

Byte[] : données brutes représentées par l'argument encodé en base64 sous la forme d'un tableau d'octets.


base64DecodeWebSafe(encoded)

Décode une chaîne encodée en base64 adaptée au Web en un tableau d'octets 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());

Paramètres

NomTypeDescription
encodedStringTableau d'octets de données Web à décoder.

Renvois

Byte[] : données brutes représentées par l'argument encodé en base64 adapté au Web sous la forme d'un tableau d'octets.


base64DecodeWebSafe(encoded, charset)

Décode une chaîne encodée en base64 Web sécurisée en un tableau d'octets dans un jeu de caractères spécifique.

// 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());

Paramètres

NomTypeDescription
encodedStringChaîne de données Web à décoder.
charsetCharsetUne valeur Charset spécifiant le jeu de caractères de l'entrée.

Renvois

Byte[] : données brutes représentées par l'argument encodé en base64 adapté au Web sous la forme d'un tableau d'octets.


base64Encode(data)

Génère une chaîne encodée en base64 à partir du tableau d'octets donné. La base 64 est un encodage commun accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base64 est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents 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);

Paramètres

NomTypeDescription
dataByte[]Octet[] de données à encoder.

Renvois

String : représentation des données transmises, encodée en base64.


base64Encode(data)

Génère une chaîne encodée en base64 à partir de la chaîne donnée. Le format base64 est un encodage courant accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base64 est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents XML.

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

Paramètres

NomTypeDescription
dataStringChaîne à encoder.

Renvois

String : représentation de la chaîne d'entrée encodée en base64.


base64Encode(data, charset)

Génère une chaîne encodée en base64 à partir de la chaîne donnée dans un jeu de caractères spécifique. Un Charset est un moyen d'encoder des caractères de sorte qu'ils puissent l'être. Celles-ci sont généralement effectuées dans un format binaire, qui peut généralement être incompatible avec certains protocoles de transmission de données. Pour rendre les données compatibles, elles sont généralement encodées en base 64, un encodage commun accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base64 est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents 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);

Paramètres

NomTypeDescription
dataStringChaîne de données à encoder.
charsetCharsetUne valeur Charset spécifiant le jeu de caractères de l'entrée.

Renvois

String : représentation encodée en base64 de la chaîne d'entrée avec le Charset donné.


base64EncodeWebSafe(data)

Génère une chaîne encodée en base64 adaptée au Web à partir du tableau d'octets donné. Le format Base64 est un encodage courant accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base 64 adapté au Web est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents 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);

Paramètres

NomTypeDescription
dataByte[]Tableau d'octets de données à encoder.

Renvois

String : représentation des données transmises, encodée en base64 et adaptée au Web.


base64EncodeWebSafe(data)

Génère une chaîne encodée en base64 adaptée au Web à partir de la chaîne donnée. La base 64 est un encodage commun accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base 64 adapté au Web est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents XML.

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

Paramètres

NomTypeDescription
dataStringChaîne à encoder.

Renvois

String : représentation de la chaîne d'entrée, encodée en base64 et adaptée au Web.


base64EncodeWebSafe(data, charset)

Génère une chaîne encodée en base64 adaptée au Web à partir de la chaîne donnée dans un jeu de caractères spécifique. Un jeu de caractères est un moyen d'encoder des caractères de sorte qu'ils puissent l'être. Celles-ci sont généralement effectuées dans un format binaire, qui peut généralement être incompatible avec certains protocoles de transmission de données. Pour rendre les données compatibles, elles sont généralement encodées en base64, un encodage commun accepté par divers outils qui ne peuvent pas accepter les données binaires. Base 64 adapté au Web est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents 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);

Paramètres

NomTypeDescription
dataStringChaîne de données à encoder.
charsetCharsetUne valeur Charset spécifiant le jeu de caractères de l'entrée.

Renvois

String : représentation encodée en base64 et encodée en base64 de la chaîne d'entrée avec le Charset donné.


computeDigest(algorithm, value)

Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur Byte[] spécifiée.

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

Paramètres

NomTypeDescription
algorithmDigestAlgorithmUn DigestAlgorithm à utiliser.
valueByte[]Valeur de chaîne d'entrée pour laquelle calculer un condensé.

Renvois

Byte[] : octet[] représentant le condensé de sortie.


computeDigest(algorithm, value)

Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur String spécifiée.

var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, "input to hash");
Logger.log(digest);

Paramètres

NomTypeDescription
algorithmDigestAlgorithmUn DigestAlgorithm à utiliser.
valueStringValeur de chaîne d'entrée pour laquelle calculer un condensé.

Renvois

Byte[] : octet[] représentant le condensé de sortie.


computeDigest(algorithm, value, charset)

Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur String spécifiée avec le jeu de caractères indiqué.

var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5,
                                     "input to hash",
                                     Utilities.Charset.US_ASCII);
Logger.log(digest);

Paramètres

NomTypeDescription
algorithmDigestAlgorithmUn DigestAlgorithm à utiliser.
valueStringValeur de chaîne d'entrée pour laquelle calculer un condensé.
charsetCharsetUne chaîne Charset représentant le jeu de caractères d'entrée.

Renvois

Byte[] : octet[] représentant le condensé de sortie.


computeHmacSha256Signature(value, key)

Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé donnée.

// 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);

Paramètres

NomTypeDescription
valueByte[]Valeur d'entrée pour laquelle générer un hachage.
keyByte[]Une clé à utiliser pour générer le hachage.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeHmacSha256Signature(value, key)

Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé donnée.

// 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);

Paramètres

NomTypeDescription
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringUne clé à utiliser pour générer le hachage.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeHmacSha256Signature(value, key, charset)

Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé et le jeu de caractères donnés.

// 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);

Paramètres

NomTypeDescription
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringUne clé à utiliser pour générer le hachage.
charsetCharsetUne chaîne Charset représentant le jeu de caractères d'entrée.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeHmacSignature(algorithm, value, key)

Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées.

// 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);

Paramètres

NomTypeDescription
algorithmMacAlgorithmUn algorithme MacAlgorithm à utiliser pour hacher la valeur d'entrée.
valueByte[]Valeur d'entrée pour laquelle générer un hachage.
keyByte[]Une clé à utiliser pour générer le hachage.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeHmacSignature(algorithm, value, key)

Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées.

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5,
                                               "input to hash",
                                               "key");
Logger.log(signature);

Paramètres

NomTypeDescription
algorithmMacAlgorithmUn algorithme MacAlgorithm à utiliser pour hacher la valeur d'entrée.
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringUne clé à utiliser pour générer le hachage.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeHmacSignature(algorithm, value, key, charset)

Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées.

// 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);

Paramètres

NomTypeDescription
algorithmMacAlgorithmUn algorithme MacAlgorithm à utiliser pour hacher la valeur d'entrée.
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringUne clé à utiliser pour générer le hachage.
charsetCharsetUne chaîne Charset représentant le jeu de caractères d'entrée.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeRsaSha1Signature(value, key)

Signe la valeur fournie à l'aide de RSA-SHA1 avec la clé donnée.

// 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);

Paramètres

NomTypeDescription
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringClé au format PEM à utiliser pour générer la signature.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeRsaSha1Signature(value, key, charset)

Signe la valeur fournie à l'aide de RSA-SHA1 avec la clé et le jeu de caractères donnés.

// 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);

Paramètres

NomTypeDescription
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringClé au format PEM à utiliser pour générer la signature.
charsetCharsetUne chaîne Charset représentant le jeu de caractères d'entrée.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeRsaSha256Signature(value, key)

Signe la valeur fournie à l'aide de RSA-SHA256 avec la clé donnée.

// 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);

Paramètres

NomTypeDescription
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringClé au format PEM à utiliser pour générer la signature.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeRsaSha256Signature(value, key, charset)

Signe la valeur fournie à l'aide de RSA-SHA256 avec la clé donnée.

// 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);

Paramètres

NomTypeDescription
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringClé au format PEM à utiliser pour générer la signature.
charsetCharsetUne chaîne Charset représentant le jeu de caractères d'entrée.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeRsaSignature(algorithm, value, key)

Signe la valeur fournie à l'aide de l'algorithme RSA spécifié avec la clé donnée.

// 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);

Paramètres

NomTypeDescription
algorithmRsaAlgorithmUn algorithme RsaAlgorithm à utiliser pour hacher la valeur d'entrée.
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringClé au format PEM à utiliser pour générer la signature.

Renvois

Byte[] : octet[] représentant la signature de sortie.


computeRsaSignature(algorithm, value, key, charset)

Signe la valeur fournie à l'aide de l'algorithme RSA spécifié avec la clé et le jeu de caractères donnés.

// 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);

Paramètres

NomTypeDescription
algorithmRsaAlgorithmUn algorithme RsaAlgorithm à utiliser pour hacher la valeur d'entrée.
valueStringValeur d'entrée pour laquelle générer un hachage.
keyStringClé au format PEM à utiliser pour générer la signature.
charsetCharsetUne chaîne Charset représentant le jeu de caractères d'entrée.

Renvois

Byte[] : octet[] représentant la signature de sortie.


formatDate(date, timeZone, format)

Met en forme les dates conformément à la spécification décrite dans la classe Java SE SimpleDateFormat. Veuillez consulter la spécification à l'adresse 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);

Paramètres

NomTypeDescription
dateDateUn élément Date à mettre en forme en tant que chaîne.
timeZoneStringFuseau horaire de sortie du résultat.
formatStringFormat conforme à la spécification SimpleDateFormat.

Renvois

String : date d'entrée sous forme de chaîne mise en forme.


formatString(template, args)

Effectue une mise en forme de chaîne de type sprintf à l'aide de chaînes de format "%".

// " 123.456000"
Utilities.formatString('%11.6f', 123.456);

// "   abc"
Utilities.formatString('%6s', 'abc');

Paramètres

NomTypeDescription
templateStringChaîne de format qui contrôle les éléments renvoyés.
argsObject...Objets à utiliser pour remplir les espaces réservés "%" dans le modèle.

Renvois

String : chaîne mise en forme.


getUuid()

Obtenez un UUID sous forme de chaîne (cela équivaut à l'utilisation de la méthode java.util.UUID.randomUUID()). Il n'est pas garanti que cet identifiant soit unique pour toutes les périodes et tous les espaces. Par conséquent, ne l'utilisez pas dans les situations où l'unicité garantie est requise.

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

Renvois

String : représentation de l'UUID sous forme de chaîne.


gzip(blob)

gzip compresse les données Blob fournies et les renvoie dans un nouvel objet Blob.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

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

Paramètres

NomTypeDescription
blobBlobSourceUn objet Blob à compresser à l'aide de gzip.

Renvois

Blob : nouveau Blob contenant les données compressées.


gzip(blob, name)

gzip compresse les données Blob fournies et les renvoie dans un nouvel objet Blob. Cette version de la méthode permet de spécifier un nom de fichier.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

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

Paramètres

NomTypeDescription
blobBlobSourceUn objet Blob à compresser à l'aide de gzip.
nameStringNom du fichier gzip à créer.

Renvois

Blob : nouveau Blob contenant les données compressées.


newBlob(data)

Crée un objet Blob à partir d'un tableau d'octets. Les blobs sont utilisés dans de nombreuses API Apps Script qui reçoivent des données binaires en entrée.

// 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());

Paramètres

NomTypeDescription
dataByte[]Octets de l'objet blob.

Renvois

Blob : objet blob nouvellement créé.


newBlob(data, contentType)

Crée un objet Blob à partir d'un tableau d'octets et d'un type de contenu. Les blobs sont utilisés dans de nombreuses API Apps Script qui acceptent des données binaires en entrée.

// 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());

Paramètres

NomTypeDescription
dataByte[]Octets de l'objet blob.
contentTypeStringLe type de contenu de l'objet blob peut être null.

Renvois

Blob : objet blob nouvellement créé.


newBlob(data, contentType, name)

Créez un objet Blob à partir d'un tableau d'octets, d'un type de contenu et d'un nom. Les blobs sont utilisés dans de nombreuses API Apps Script qui acceptent des données binaires en entrée.

// 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());

Paramètres

NomTypeDescription
dataByte[]Octets de l'objet blob.
contentTypeString: type de contenu de l'objet blob (null).
nameStringLe nom de l'objet blob peut être null.

Renvois

Blob : objet blob nouvellement créé.


newBlob(data)

Crée un objet Blob à partir d'une chaîne. Les blobs sont utilisés dans de nombreuses API Apps Script qui reçoivent des données binaires en entrée.

// 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());

Paramètres

NomTypeDescription
dataStringChaîne de l'objet blob, supposée en UTF-8.

Renvois

Blob : objet blob nouvellement créé.


newBlob(data, contentType)

Créez un objet Blob à partir d'une chaîne et d'un type de contenu. Les blobs sont utilisés dans de nombreuses API Apps Script qui acceptent des données binaires en entrée.

// 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());

Paramètres

NomTypeDescription
dataStringChaîne de l'objet blob, supposée en UTF-8.
contentTypeStringLe type de contenu de l'objet blob peut être null.

Renvois

Blob : objet blob nouvellement créé.


newBlob(data, contentType, name)

Créez un objet Blob à partir d'une chaîne, d'un type de contenu et d'un nom. Les blobs sont utilisés dans de nombreuses API Apps Script qui acceptent des données binaires en entrée.

// 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());

Paramètres

NomTypeDescription
dataStringChaîne de l'objet blob, supposée en UTF-8.
contentTypeStringLe type de contenu de l'objet blob peut être null.
nameStringLe nom de l'objet blob peut être null.

Renvois

Blob : objet blob nouvellement créé.


parseCsv(csv)

Renvoie la représentation sous forme de tableau 2D d'une chaîne CSV sous forme de tableau 2D.

// 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);

Paramètres

NomTypeDescription
csvStringChaîne contenant des données uniques ou multilignes au format CSV (valeurs séparées par des virgules).

Renvois

String[][] : tableau bidimensionnel contenant les valeurs de la chaîne CSV.


parseCsv(csv, delimiter)

Renvoie une représentation sous forme de tableau 2D tabulaire d'une chaîne CSV à l'aide d'un délimiteur personnalisé.

// 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');

Paramètres

NomTypeDescription
csvStringChaîne contenant des données uniques ou multilignes au format CSV (valeurs séparées par des virgules).
delimiterCharEntre les valeurs.

Renvois

String[][] : tableau bidimensionnel contenant les valeurs de la chaîne CSV.


parseDate(date, timeZone, format)

Analyse la date de chaîne fournie selon la spécification décrite dans la classe SimpleDateFormat de l'édition Java standard. Pour en savoir plus, consultez la section Classe SimpleDateFormat de Java.

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

Paramètres

NomTypeDescription
dateStringValeur de chaîne à analyser comme date.
timeZoneStringFuseau horaire de sortie.
formatStringFormat de date conformément à la spécification SimpleDateFormat.

Renvois

Date : chaîne d'entrée sous forme de date.


sleep(milliseconds)

Mise en veille pendant le nombre de millisecondes spécifié. Met immédiatement le script en veille pendant le nombre de millisecondes spécifié. La valeur maximale autorisée est de 300 000 (soit 5 minutes).

// 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());

Paramètres

NomTypeDescription
millisecondsIntegerDurée de mise en veille (en millisecondes).

ungzip(blob)

Décompresse un objet Blob et renvoie un Blob contenant les données non compressées.

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);

Paramètres

NomTypeDescription
blobBlobSourceBlob de données compressées.

Renvois

Blob : Blob représentant les données décompressées.


unzip(blob)

Prend un objet Blob représentant un fichier ZIP et renvoie ses fichiers composant.

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);

Paramètres

NomTypeDescription
blobBlobSourceBlob du fichier ZIP.

Renvois

Blob[] : Blob[] représentant les blobs des composants, chacun nommé avec le chemin d'accès complet à l'intérieur du ZIP.


zip(blobs)

Crée un objet Blob qui est un fichier ZIP contenant les données des objets Blob transmis.

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]);

Paramètres

NomTypeDescription
blobsBlobSource[]Tableau de blobs à compresser.

Renvois

Blob : nouveau blob contenant les entrées sous forme d'archive.


zip(blobs, name)

Crée un objet Blob qui est un fichier ZIP contenant les données des objets Blob transmis. Cette version de la méthode permet de spécifier un nom de fichier.

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");

Paramètres

NomTypeDescription
blobsBlobSource[]Tableau de blobs à compresser.
nameStringNom du fichier ZIP à créer.

Renvois

Blob : nouveau blob contenant les entrées sous forme d'archive.

Méthodes obsolètes