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înes, la mise en forme de dates, 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 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 sécurisée pour le Web en tableau d'octets UTF-8.
`base64DecodeWebSafe(encoded, charset)`	`Byte[]`	Décode une chaîne encodée en base64 adaptée au Web en 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 de la matrice d'octets donnée.
`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 en base64 adaptée au Web à partir de l'array d'octets donné.
`base64EncodeWebSafe(data)`	`String`	Génère une chaîne encodée en base64 adaptée au Web à partir de la chaîne donnée.
`base64EncodeWebSafe(data, charset)`	`String`	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.
`computeDigest(algorithm, value)`	`Byte[]`	Calculez un récapitulatif à l'aide de l'algorithme spécifié pour la valeur `Byte[]` spécifiée.
`computeDigest(algorithm, value)`	`Byte[]`	Calculez un récapitulatif à l'aide de l'algorithme spécifié pour la valeur `String` spécifiée.
`computeDigest(algorithm, value, charset)`	`Byte[]`	Calculez un récapitulatif à l'aide de l'algorithme spécifié sur la valeur `String` spécifiée avec l'ensemble 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[]`	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 l'encodage 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)`	`String`	Met en forme la date conformément aux spécifications décrites dans la classe SimpleDateFormat de Java SE.
`formatString(template, args)`	`String`	Effectue la mise en forme de chaînes semblable à `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 de tableau à deux dimensions d'une chaîne CSV.
`parseCsv(csv, delimiter)`	`String[][]`	Renvoie une représentation de tableau à deux dimensions 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 aux spécifications décrites dans la classe `SimpleDateFormat` de l'édition standard de Java.
`sleep(milliseconds)`	`void`	Met l'appareil en veille pendant le nombre de millisecondes spécifié.
`ungzip(blob)`	`Blob`	Décompresse un objet `Blob` et renvoie un `Blob` contenant les données non compressées.
`unzip(blob)`	`Blob[]`	Prend un blob représentant un fichier ZIP et renvoie ses fichiers composants.
`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`	Renvoie 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 tableau d'octets 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());

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 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 グループ"
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());

Paramètres

Nom	Type	Description
`encoded`	`String`	Chaîne de données à décoder.
`charset`	`Charset`	`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 sécurisée pour le Web en tableau d'octets 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());

Paramètres

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

Renvois

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

`base64DecodeWebSafe(encoded, charset)`

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

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

Paramètres

Nom	Type	Description
`encoded`	`String`	Chaîne de données Web-safe à décoder.
`charset`	`Charset`	`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 sécurisé pour le Web sous la forme d'un tableau d'octets.

`base64Encode(data)`

Génère une chaîne encodée en base64 à partir de la matrice d'octets donnée. L'encodage Base64 est un codage courant accepté par divers outils qui ne peuvent pas accepter de données binaires. La base 64 est couramment utilisée dans les protocoles Internet tels que le courrier électronique, HTTP ou les documents 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);

Paramètres

Nom	Type	Description
`data`	`Byte[]`	Un byte[] 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. L'encodage Base64 est un codage courant accepté par divers outils qui ne peuvent pas accepter de données binaires. La base 64 est couramment utilisée dans les protocoles Internet tels que la messagerie, HTTP ou les documents XML.

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

Paramètres

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

Renvois

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

`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. Ils sont généralement effectués 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 codage courant accepté par divers outils qui ne peuvent pas accepter de données binaires. La base 64 est couramment utilisée dans les protocoles Internet tels que le courrier électronique, HTTP ou les documents 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);

Paramètres

Nom	Type	Description
`data`	`String`	Chaîne de données à encoder.
`charset`	`Charset`	`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 de l'array d'octets donné. Base64 est un codage courant accepté par divers outils qui ne peuvent pas accepter de données binaires. L'encodage base 64 Web-safe est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents 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);

Paramètres

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

Renvois

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

`base64EncodeWebSafe(data)`

Génère une chaîne encodée en base64 adaptée au Web à partir de la chaîne donnée. L'encodage Base64 est un codage courant accepté par divers outils qui ne peuvent pas accepter de données binaires. L'encodage base 64 Web-safe est couramment utilisé dans les protocoles Internet tels que le courrier électronique, HTTP ou les documents XML.

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const 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 en base64 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 afin qu'ils puissent être encodés. Ils sont généralement effectués au 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 codage courant accepté par divers outils qui ne peuvent pas accepter de données binaires. L'encodage base 64 Web-safe est couramment utilisé dans les protocoles Internet tels que le courrier électronique, HTTP ou les documents 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);

Paramètres

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

Renvois

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

`computeDigest(algorithm, value)`

Calculez un récapitulatif à l'aide de l'algorithme spécifié pour la valeur Byte[] spécifiée.

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

Paramètres

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

Renvois

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

`computeDigest(algorithm, value)`

Calculez un récapitulatif à l'aide de l'algorithme spécifié pour la valeur String spécifiée.

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

Paramètres

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

Renvois

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

`computeDigest(algorithm, value, charset)`

Calculez un récapitulatif à l'aide de l'algorithme spécifié sur la valeur String spécifiée avec l'ensemble de caractères donné.

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

Paramètres

Nom	Type	Description
`algorithm`	`DigestAlgorithm`	Un `DigestAlgorithm` à utiliser.
`value`	`String`	Valeur de chaîne d'entrée pour laquelle calculer un récapitulatif.
`charset`	`Charset`	`Charset` représentant le jeu de caractères d'entrée.

Renvois

Byte[] : octet[] représentant le récapitulatif 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.
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);

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.
const 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.
const 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`	`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.
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);

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

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

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.
const 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`	`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.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
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 l'encodage de caractères donnés.

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

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`	`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.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
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.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
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`	`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.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
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 donnés.

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

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`	`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 aux spécifications décrites dans la classe SimpleDateFormat de Java SE. Veuillez consulter la spécification sur la page 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);

Paramètres

Nom	Type	Description
`date`	`Date`	`Date` à mettre en forme sous forme de 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 la mise en forme de chaînes semblable à 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 renseigner 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 (équivalent à l'utilisation de la méthode java.util.UUID.randomUUID()). Il n'est pas garanti que cet identifiant soit unique dans le temps et l'espace. Par conséquent, n'utilisez pas cette valeur dans les cas où l'unicité doit être garantie.

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

Renvois

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

`gzip(blob)`

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

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

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

Paramètres

Nom	Type	Description
`blob`	`BlobSource`	Objet `Blob` à compresser à l'aide de `gzip`.

Renvois

Blob : nouvel 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.

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

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

Paramètres

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

Renvois

Blob : nouvel 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 acceptent 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

Nom	Type	Description
`data`	`Byte[]`	Octets du blob.

Renvois

Blob : 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 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

Nom	Type	Description
`data`	`Byte[]`	Octets du blob.
`contentType`	`String`	Type de contenu du blob (peut être `null`).

Renvois

Blob : le 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 objets blob sont utilisés dans de nombreuses API Apps Script qui utilisent des données binaires comme 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 du blob.
`contentType`	`String`	- Le type de contenu du blob peut être `null`.
`name`	`String`	Nom du blob (peut être `null`).

Renvois

Blob : 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 acceptent 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

Nom	Type	Description
`data`	`String`	Chaîne du blob, supposée être au format UTF-8.

Renvois

Blob : le 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 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

Nom	Type	Description
`data`	`String`	Chaîne du blob, supposée être au format UTF-8.
`contentType`	`String`	Type de contenu du blob (peut être `null`).

Renvois

Blob : le 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 objets blob sont utilisés dans de nombreuses API Apps Script qui utilisent des données binaires comme 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 du blob, supposée être au format UTF-8.
`contentType`	`String`	Type de contenu du blob (peut être `null`).
`name`	`String`	Nom du blob (peut être `null`).

Renvois

Blob : le blob nouvellement créé.

`parseCsv(csv)`

Renvoie une représentation de tableau à deux dimensions d'une chaîne 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);

Paramètres

Nom	Type	Description
`csv`	`String`	Chaîne contenant des données uniques ou multilignes au format 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 à deux dimensions 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]]
const csvString = 'a\tb\tc\nd\te\tf';
const data = Utilities.parseCsv(csvString, '\t');

Paramètres

Nom	Type	Description
`csv`	`String`	Chaîne contenant des données uniques ou multilignes au format 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 aux spécifications décrites dans la classe SimpleDateFormat de l'édition standard de Java. Pour en savoir plus, consultez 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.
const 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 aux spécifications `SimpleDateFormat`.

Renvois

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

`sleep(milliseconds)`

Met l'appareil 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 (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 de mise en veille.

`ungzip(blob)`

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

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

Paramètres

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

Renvois

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

`unzip(blob)`

Prend un blob représentant un fichier ZIP et renvoie ses fichiers composants.

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

Paramètres

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

Renvois

Blob[] : Blob[] représentant les blobs de composant, chacun nommé avec le chemin d'accès complet dans le fichier ZIP.

`zip(blobs)`

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

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

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. Cette version de la méthode permet de spécifier un nom de fichier.

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

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. Remplacement par JSON.parse() depuis novembre 2013

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

// Returns the object { name: "John Smith", company: "Virginia Company"}
const 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 de l'entrée sous forme d'objet JavaScript.

`jsonStringify(obj)`

Obsolète. Remplacement par JSON.stringify() depuis novembre 2013

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

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

Paramètres

Nom	Type	Description
`obj`	`Object`	l'objet JavaScript à sérialiser au format JSON ;

Renvois

String : objet JavaScript sérialisé au format JSON