Class Utilities

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

Aller-retour

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

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

Aller-retour

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

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

Aller-retour

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

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

Aller-retour

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

Génère une chaîne encodée en base64 à partir du tableau d'octets donné. L'encodage Base 64 est communément accepté par divers outils qui ne peuvent pas accepter les données binaires. La norme Base 64 est couramment utilisée dans les protocoles Internet tels que les e-mails, le protocole 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

Aller-retour

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

Génère une chaîne encodée en base64 à partir de la chaîne donnée. L'encodage Base 64 est communément accepté par divers outils qui ne peuvent pas accepter les données binaires. La norme Base 64 est communément utilisée dans les protocoles Internet tels que les e-mails, le protocole HTTP ou les documents XML.

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

Paramètres

Aller-retour

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

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 permet d'encoder des caractères de sorte qu'ils puissent l'être. 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 assurer la compatibilité des données, elles sont généralement encodées en base 64, un encodage courant accepté par divers outils ne pouvant pas accepter les données binaires. La norme Base 64 est couramment utilisée dans les protocoles Internet tels que les e-mails, le protocole 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

Aller-retour

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

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

Aller-retour

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

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

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

Paramètres

Aller-retour

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

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 charset permet d'encoder des caractères de sorte qu'ils puissent l'être. Elles sont généralement effectuées au format binaire, qui n'est généralement pas compatible avec certains protocoles de transmission de données. Pour assurer la compatibilité des données, elles sont généralement encodées en base 64, un encodage courant accepté par divers outils qui ne peuvent pas accepter les données binaires. Le protocole Base 64 adapté au Web est couramment utilisé dans les protocoles Internet tels que les e-mails, le protocole 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

Aller-retour

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

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

Aller-retour

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

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

Aller-retour

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

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

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

Paramètres

Aller-retour

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

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

Aller-retour

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

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

Aller-retour

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

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

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

Aller-retour

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

Calcule 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

Aller-retour

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

Calcule 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

Aller-retour

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

Calcule 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

Aller-retour

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

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

Aller-retour

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

Signe la valeur fournie à l'aide de RSA-SHA1 avec la clé et le charset 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

Aller-retour

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

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

Aller-retour

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

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

Aller-retour

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

Signe la valeur fournie à l'aide de l'algorithme RSA 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

Aller-retour

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

Signe la valeur fournie à l'aide de l'algorithme RSA avec la clé et le charset 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

Aller-retour

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

Formate la date conformément aux spécifications décrites 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

Aller-retour

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

Effectue une mise en forme 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

Aller-retour

String : chaîne mise en forme.

Obtenez un UUID en tant que chaîne (ce qui équivaut à utiliser 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 les utilisez pas dans les situations où une unicité 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();
};

Aller-retour

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

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

Aller-retour

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

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

Aller-retour

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

Créez un objet Blob à partir d'un tableau d'octets. Les blobs 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

Aller-retour

Blob : blob créé.

Créez 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

Aller-retour

Blob : blob créé.

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

Aller-retour

Blob : blob créé.

Créez un objet Blob à partir d'une chaîne. 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';

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

Aller-retour

Blob : blob créé.

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

Aller-retour

Blob : blob créé.

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

Aller-retour

Blob : blob créé.

Renvoie une représentation tabulaire tabulaire 2D d'une chaîne CSV.

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

Aller-retour

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

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

Aller-retour

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

Analyse la date de chaîne fournie selon la spécification décrite dans la classe SimpleDateFormat de l'édition standard 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.
var date = Utilities.parseDate("1970-01-01 00:00:00", "GMT", "yyyy-MM-dd' 'HH:mm:ss");
Logger.log(date);

Paramètres

Aller-retour

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

Se met 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

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

Aller-retour

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

Prend un blob représentant un fichier ZIP et renvoie ses fichiers de 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

Aller-retour

Blob[] : blob[] représentant les blobs des composants, chacun étant nommé par le chemin d'accès complet dans le ZIP.

Crée un objet Blob constitué d'un fichier ZIP contenant les données des blobs 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

Aller-retour

Blob : nouveau blob contenant les entrées en tant qu'archive.

Crée un objet Blob constitué d'un fichier ZIP contenant les données des blobs 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

Aller-retour

Blob : nouveau blob contenant les entrées en tant qu'archive.