Cette page a été traduite par l'API Cloud Translation.

Class Utilities

Ce service fournit des utilitaires pour l'encodage/le décodage de chaîne, le formatage de la date, la manipulation JSON, et d'autres tâches diverses.

Propriétés

Propriété	Type	Description
`Charset`	`Charset`
`DigestAlgorithm`	`DigestAlgorithm`
`MacAlgorithm`	`MacAlgorithm`
`RsaAlgorithm`	`RsaAlgorithm`

Méthodes

Méthode	Type 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 un tableau d'octets dans un jeu de caractères spécifique.
`base64DecodeWebSafe(encoded)`	`Byte[]`	Décode une chaîne Web sécurisée en base64 en un tableau d'octets UTF-8.
`base64DecodeWebSafe(encoded, charset)`	`Byte[]`	Décode une chaîne Web sécurisée en base64 en un tableau d'octets dans un jeu de caractères spécifique.
`base64Encode(data)`	`String`	Génère une chaîne encodée en base64 à partir du tableau d'octets donné.
`base64Encode(data)`	`String`	Génère une chaîne encodée en base64 à partir de la chaîne donnée.
`base64Encode(data, charset)`	`String`	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.
`base64EncodeWebSafe(data)`	`String`	Génère une chaîne encodée au format Web en base64 à partir du tableau d'octets donné.
`base64EncodeWebSafe(data)`	`String`	Génère une chaîne Web sécurisée en base64 à partir de la chaîne donnée.
`base64EncodeWebSafe(data, charset)`	`String`	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.
`computeDigest(algorithm, value)`	`Byte[]`	Calcule un condensé à l'aide de l'algorithme spécifié sur la valeur `Byte[]` spécifiée.
`computeDigest(algorithm, value)`	`Byte[]`	Calcule un condensé à l'aide de l'algorithme spécifié sur la valeur `String` spécifiée.
`computeDigest(algorithm, value, charset)`	`Byte[]`	Calculer un condensé à l'aide de l'algorithme spécifié sur la valeur `String` spécifiée avec la jeu de caractères donné.
`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[]`	Calculer un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé spécifiée et .
`computeHmacSignature(algorithm, value, key)`	`Byte[]`	Calculer un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé spécifiée et .
`computeHmacSignature(algorithm, value, key, charset)`	`Byte[]`	Calculer un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé spécifiée et .
`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é et de 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 indiqués.
`formatDate(date, timeZone, format)`	`String`	Met en forme la date conformément à la spécification décrite dans la classe SimpleDateFormat Java SE.
`formatString(template, args)`	`String`	Effectue une mise en forme de chaîne de type `sprintf` à l'aide de chaînes de format de style '%'.
`getUuid()`	`String`	Obtenez un UUID sous forme de chaîne (équivalent à l'utilisation de la méthode `java.util.UUID.randomUUID()`).
`gzip(blob)`	`Blob`	`gzip` compresse les données `Blob` fournies et les renvoie dans un nouvel objet `Blob`.
`gzip(blob, name)`	`Blob`	`gzip` compresse les données `Blob` fournies et les renvoie dans un nouvel objet `Blob`.
`newBlob(data)`	`Blob`	Créez un objet Blob à partir d'un tableau d'octets.
`newBlob(data, contentType)`	`Blob`	Créez un objet Blob à partir d'un tableau d'octets et d'un type de contenu.
`newBlob(data, contentType, name)`	`Blob`	Créez un objet Blob à partir d'un tableau d'octets, d'un type de contenu et d'un nom.
`newBlob(data)`	`Blob`	Créez un objet Blob à partir d'une chaîne.
`newBlob(data, contentType)`	`Blob`	Créez un objet Blob à partir d'une chaîne et d'un type de contenu.
`newBlob(data, contentType, name)`	`Blob`	Créez un objet Blob à partir d'une chaîne, d'un type de contenu et d'un nom.
`parseCsv(csv)`	`String[][]`	Renvoie une représentation d'une chaîne CSV sous la forme d'un tableau 2D tabulaire.
`parseCsv(csv, delimiter)`	`String[][]`	Renvoie une représentation de tableau 2D tabulaire d'une chaîne CSV à l'aide d'un délimiteur personnalisé.
`parseDate(date, timeZone, format)`	`Date`	Analyse la date de la chaîne fournie conformément à la spécification décrite dans le document standard Java Classe de l'édition `SimpleDateFormat`.
`sleep(milliseconds)`	`void`	Mise en veille pendant le nombre spécifié de millisecondes.
`ungzip(blob)`	`Blob`	Décompresse un objet `Blob` et renvoie un `Blob` contenant l'objet non compressé données.
`unzip(blob)`	`Blob[]`	Accepte en entrée un objet Blob représentant un fichier ZIP et renvoie les fichiers qui la composent.
`zip(blobs)`	`Blob`	Crée un objet Blob qui est un fichier ZIP contenant les données des objets Blob transmis.
`zip(blobs, name)`	`Blob`	Crée un objet Blob qui est un fichier ZIP contenant les données des objets Blob transmis.

Méthodes obsolètes

Méthode	Type renvoyé	Brève description
`jsonParse(jsonString)`	`Object`	Renvoyez un objet correspondant à la chaîne JSON transmise.
`jsonStringify(obj)`	`String`	Renvoie une chaîne JSON de l'objet 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

Nom	Type	Description
`encoded`	`String`	Tableau d'octets de données à décoder.

Renvois

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

`base64Decode(encoded, charset)`

Décode une chaîne encodée en base64 en un 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

Nom	Type	Description
`encoded`	`String`	Chaîne de données à décoder.
`charset`	`Charset`	Une 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 forme de tableau d'octets.

`base64DecodeWebSafe(encoded)`

Décode une chaîne Web sécurisée en base64 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

Nom	Type	Description
`encoded`	`String`	Tableau d'octets de données Web à décoder.

Renvois

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

`base64DecodeWebSafe(encoded, charset)`

Décode une chaîne Web sécurisée en base64 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

Nom	Type	Description
`encoded`	`String`	Chaîne de données Web à décoder.
`charset`	`Charset`	Une 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 forme de tableau d'octets.

`base64Encode(data)`

Génère une chaîne encodée en base64 à partir du tableau d'octets donné. Le codage Base64 est courant accepté par une variété d’outils qui n’acceptent pas les données binaires. Le Base64 est couramment utilisé dans 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

Nom	Type	Description
`data`	`Byte[]`	Octet[] de données à encoder.

Renvois

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

`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 Base64 est couramment utilisé sur 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

Nom	Type	Description
`data`	`String`	Chaî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 jeu de caractères est un moyen d'encoder des caractères afin qu'ils puissent être encodés. Ces opérations sont généralement réalisées format binaire, qui peut généralement être incompatible avec certains protocoles de transmission de données. À rendent les données compatibles, elles sont généralement encodées en base64, qui est un codage courant accepté par une variété d’outils qui n’acceptent pas les données binaires. Le Base64 est couramment utilisé dans 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

Nom	Type	Description
`data`	`String`	Chaîne de données à encoder.
`charset`	`Charset`	Une 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 la valeur Charset donnée.

`base64EncodeWebSafe(data)`

Génère une chaîne encodée au format Web en base64 à partir du tableau d'octets donné. Le format Base64 est une référence l’encodage accepté par divers outils qui n'acceptent pas les données binaires. Le format Base64 adapté au Web est communément utilisé dans les protocoles Internet tels que le courrier électronique, HTTP ou dans 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

Nom	Type	Description
`data`	`Byte[]`	Tableau d'octets de données à encoder.

Renvois

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

`base64EncodeWebSafe(data)`

Génère une chaîne Web sécurisée en base64 à partir de la chaîne donnée. Le codage Base64 est courant accepté par une variété d’outils qui n’acceptent pas les données binaires. Adapté au Web en base 64, utilisés dans les protocoles Internet tels que les e-mails, HTTP ou dans les documents XML.

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

Paramètres

Nom	Type	Description
`data`	`String`	Chaîne à encoder.

Renvois

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

`base64EncodeWebSafe(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 jeu de caractères est un moyen d'encoder des caractères pour qu'ils puissent être encodés. Il s'agit généralement effectuée dans un format binaire, qui peut généralement être incompatible avec certaines transmissions de données protocoles. Pour rendre les données compatibles, elles sont généralement encodées en base64, qui est une l’encodage courant accepté par une variété d'outils qui ne peuvent pas accepter les données binaires. Adapté au Web selon la base 64 est couramment utilisé dans les protocoles Internet tels que le courrier électronique, HTTP ou dans 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

Nom	Type	Description
`data`	`String`	Chaîne de données à encoder.
`charset`	`Charset`	Une valeur `Charset` spécifiant le jeu de caractères de l'entrée.

Renvois

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

`computeDigest(algorithm, value)`

Calcule 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

Nom	Type	Description
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` à utiliser.
`value`	`Byte[]`	Valeur de chaîne d'entrée pour laquelle calculer un condensé.

Renvois

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

`computeDigest(algorithm, value)`

Calcule 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

Nom	Type	Description
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` à utiliser.
`value`	`String`	Valeur de chaîne d'entrée pour laquelle calculer un condensé.

Renvois

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

`computeDigest(algorithm, value, charset)`

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

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

Paramètres

Nom	Type	Description
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` à utiliser.
`value`	`String`	Valeur de chaîne d'entrée pour laquelle calculer un condensé.
`charset`	`Charset`	Un `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

Nom	Type	Description
`value`	`Byte[]`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`Byte[]`	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

Nom	Type	Description
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	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

Nom	Type	Description
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	Clé à utiliser pour générer le hachage.
`charset`	`Charset`	Un `Charset` représentant le jeu de caractères d'entrée.

Renvois

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

`computeHmacSignature(algorithm, value, key)`

Calculer un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé spécifiée et .

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

Nom	Type	Description
`algorithm`	`MacAlgorithm`	Algorithme `MacAlgorithm` à utiliser pour hacher la valeur d'entrée.
`value`	`Byte[]`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`Byte[]`	Clé à utiliser pour générer le hachage.

Renvois

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

`computeHmacSignature(algorithm, value, key)`

Calculer un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé spécifiée et .

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

Nom	Type	Description
`algorithm`	`MacAlgorithm`	Algorithme `MacAlgorithm` à utiliser pour hacher la valeur d'entrée.
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	Clé à utiliser pour générer le hachage.

Renvois

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

`computeHmacSignature(algorithm, value, key, charset)`

Calculer un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé spécifiée et .

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

Nom	Type	Description
`algorithm`	`MacAlgorithm`	Algorithme `MacAlgorithm` à utiliser pour hacher la valeur d'entrée.
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	Clé à utiliser pour générer le hachage.
`charset`	`Charset`	Un `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

Nom	Type	Description
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	Clé 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

Nom	Type	Description
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	Clé au format PEM à utiliser pour générer la signature.
`charset`	`Charset`	Un `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

Nom	Type	Description
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	Clé 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

Nom	Type	Description
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	Clé au format PEM à utiliser pour générer la signature.
`charset`	`Charset`	Un `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é et de 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

Nom	Type	Description
`algorithm`	`RsaAlgorithm`	Algorithme `RsaAlgorithm` à utiliser pour hacher la valeur d'entrée.
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	Clé 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 indiqué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

Nom	Type	Description
`algorithm`	`RsaAlgorithm`	Algorithme `RsaAlgorithm` à utiliser pour hacher la valeur d'entrée.
`value`	`String`	Valeur d'entrée pour laquelle générer un hachage.
`key`	`String`	Clé au format PEM à utiliser pour générer la signature.
`charset`	`Charset`	Un `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 la date conformément à la spécification décrite dans la classe SimpleDateFormat Java SE. Veuillez consultez les spécifications sur 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

Nom	Type	Description
`date`	`Date`	`Date` à mettre en forme en tant que chaîne.
`timeZone`	`String`	Fuseau horaire de sortie du résultat.
`format`	`String`	Format 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 de style '%'.

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

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

Paramètres

Nom	Type	Description
`template`	`String`	Chaîne de format qui contrôle ce qui est renvoyé.
`args`	`Object...`	Objets à utiliser pour remplir le % des espaces réservés dans le modèle.

Renvois

String : chaîne mise en forme.

`getUuid()`

Obtenez un UUID sous forme de chaîne (équivalent à l'utilisation de la méthode java.util.UUID.randomUUID()). Il n'est pas garanti que cet identifiant soit unique tout le temps et l'espace. Par conséquent, ne l'utilisez pas dans les cas 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

Nom	Type	Description
`blob`	`BlobSource`	Un 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

Nom	Type	Description
`blob`	`BlobSource`	Un objet `Blob` à compresser à l'aide de `gzip`.
`name`	`String`	Nom du fichier `gzip` à créer.

Renvois

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

`newBlob(data)`

Créez un objet Blob à partir d'un tableau d'octets. Les objets blob sont utilisés dans de nombreuses API Apps Script qui utilisent 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

Nom	Type	Description
`data`	`Byte[]`	Octets de l'objet blob.

Renvois

Blob : objet Blob nouvellement créé.

`newBlob(data, contentType)`

Créez un objet Blob à partir d'un tableau d'octets et d'un type de contenu. Les objets blob sont utilisés dans de nombreux scripts Apps Script. API 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

Nom	Type	Description
`data`	`Byte[]`	Octets de l'objet blob.
`contentType`	`String`	Le 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 applications API de 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

Nom	Type	Description
`data`	`Byte[]`	Octets de l'objet blob.
`contentType`	`String`	- Type de contenu de l'objet blob. Peut être `null`.
`name`	`String`	Le nom de l'objet blob peut être `null`.

Renvois

Blob : objet Blob nouvellement créé.

`newBlob(data)`

Créez un objet Blob à partir d'une chaîne. Les objets blob sont utilisés dans de nombreuses API Apps Script qui utilisent 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

Nom	Type	Description
`data`	`String`	Chaîne de l'objet blob, en UTF-8 supposé.

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 objets blob sont utilisés dans de nombreux scripts Apps Script. API 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

Nom	Type	Description
`data`	`String`	Chaîne de l'objet blob, en UTF-8 supposé.
`contentType`	`String`	Le 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 applications API de 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

Nom	Type	Description
`data`	`String`	Chaîne de l'objet blob, en UTF-8 supposé.
`contentType`	`String`	Le type de contenu de l'objet blob peut être `null`.
`name`	`String`	Le nom de l'objet blob peut être `null`.

Renvois

Blob : objet Blob nouvellement créé.

`parseCsv(csv)`

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

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

Nom	Type	Description
`csv`	`String`	Chaîne contenant une seule ou plusieurs lignes dans un fichier CSV (valeurs séparées par une virgule) .

Renvois

String[][] : tableau à deux dimensions contenant les valeurs de la chaîne CSV.

`parseCsv(csv, delimiter)`

Renvoie une représentation 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

Nom	Type	Description
`csv`	`String`	Chaîne contenant une seule ou plusieurs lignes dans un fichier CSV (valeurs séparées par une virgule) .
`delimiter`	`Char`	Entre les valeurs.

Renvois

String[][] : tableau à deux dimensions contenant les valeurs de la chaîne CSV.

`parseDate(date, timeZone, format)`

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

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

Paramètres

Nom	Type	Description
`date`	`String`	Valeur de chaîne à analyser en tant que date.
`timeZone`	`String`	Fuseau horaire de sortie.
`format`	`String`	Format de date conformément à la spécification `SimpleDateFormat`.

Renvois

Date : chaîne d'entrée en tant que date.

`sleep(milliseconds)`

Mise en veille pendant le nombre spécifié de millisecondes. Met immédiatement le script en veille pour la fonction en millisecondes. La valeur maximale autorisée est de 300 000 (ou 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

Nom	Type	Description
`milliseconds`	`Integer`	Nombre de millisecondes avant de se mettre en veille.

`ungzip(blob)`

Décompresse un objet Blob et renvoie un Blob contenant l'objet non compressé donné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

Nom	Type	Description
`blob`	`BlobSource`	Le `Blob` des données compressées.

Renvois

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

`unzip(blob)`

Accepte en entrée un objet Blob représentant un fichier ZIP et renvoie les fichiers qui la composent.

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

Nom	Type	Description
`blob`	`BlobSource`	Blob du fichier ZIP.

Renvois

Blob[] : Blob[] représentant les blobs des composants, chacun étant nommé avec le chemin d'accès complet à l'intérieur de 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

Nom	Type	Description
`blobs`	`BlobSource[]`	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. Ce 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

Nom	Type	Description
`blobs`	`BlobSource[]`	Tableau de blobs à compresser.
`name`	`String`	Nom du fichier ZIP à créer.

Renvois

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

Méthodes obsolètes

`jsonParse(jsonString)`

Obsolète. À compter de novembre 2013, remplacé par JSON.parse()

Renvoyez un objet correspondant à la chaîne JSON transmise.

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

Paramètres

Nom	Type	Description
`jsonString`	`String`	Représentation sous forme de chaîne d'un objet JavaScript à désérialiser.

Renvois

Object : représentation d'un objet JavaScript de l'entrée.

`jsonStringify(obj)`

Obsolète. À compter de novembre 2013, remplacé par JSON.stringify()

Renvoie une chaîne JSON de l'objet transmis.

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

Paramètres

Nom	Type	Description
`obj`	`Object`	Objet JavaScript à sérialiser au format JSON

Renvois

String : objet JavaScript sérialisé JSON