Ce service fournit des utilitaires pour l'encodage/le décodage des chaînes, la mise en forme des dates, la manipulation JSON et d'autres tâches diverses.
Propriétés
Propriété | 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 tableau d'octets dans un jeu de caractères spécifique. |
base64DecodeWebSafe(encoded) | Byte[] | Décode une chaîne encodée en base64 adaptée au Web en un tableau d'octets UTF-8. |
base64DecodeWebSafe(encoded, charset) | Byte[] | Décode une chaîne encodée en base64 Web sécurisée en un tableau d'octets dans un jeu de caractères spécifique. |
base64Encode(data) | 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 en base64 adaptée au Web à partir du tableau 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 condensé à l'aide de l'algorithme spécifié sur la valeur Byte[] spécifiée. |
computeDigest(algorithm, value) | Byte[] | Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur String spécifiée. |
computeDigest(algorithm, value, charset) | Byte[] | Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur String spécifiée avec le jeu de caractères indiqué. |
computeHmacSha256Signature(value, key) | Byte[] | Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé donnée. |
computeHmacSha256Signature(value, key) | Byte[] | Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé donnée. |
computeHmacSha256Signature(value, key, charset) | Byte[] | Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé et le jeu de caractères donnés. |
computeHmacSignature(algorithm, value, key) | Byte[] | Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées. |
computeHmacSignature(algorithm, value, key) | Byte[] | Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées. |
computeHmacSignature(algorithm, value, key, charset) | Byte[] | Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées. |
computeRsaSha1Signature(value, key) | Byte[] | Signe la valeur fournie à l'aide de RSA-SHA1 avec la clé donnée. |
computeRsaSha1Signature(value, key, charset) | Byte[] | Signe la valeur fournie à l'aide de RSA-SHA1 avec la clé et le jeu de caractères donnés. |
computeRsaSha256Signature(value, key) | Byte[] | Signe la valeur fournie à l'aide de RSA-SHA256 avec la clé donnée. |
computeRsaSha256Signature(value, key, charset) | Byte[] | Signe la valeur fournie à l'aide de RSA-SHA256 avec la clé donnée. |
computeRsaSignature(algorithm, value, key) | Byte[] | Signe la valeur fournie à l'aide de l'algorithme RSA spécifié avec la clé donnée. |
computeRsaSignature(algorithm, value, key, charset) | Byte[] | Signe la valeur fournie à l'aide de l'algorithme RSA spécifié avec la clé et le jeu de caractères donnés. |
formatDate(date, timeZone, format) | String | Met en forme les dates conformément à la spécification décrite dans la classe Java SE SimpleDateFormat. |
formatString(template, args) | String | Effectue une mise en forme de chaîne de type sprintf à l'aide de chaînes de format "%". |
getUuid() | String | Obtenez un UUID sous forme de chaîne (cela équivaut à 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ée un objet Blob à partir d'un tableau d'octets. |
newBlob(data, contentType) | Blob | Crée 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ée 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 la représentation sous forme de tableau 2D d'une chaîne CSV sous forme de tableau 2D. |
parseCsv(csv, delimiter) | String[][] | Renvoie une représentation sous forme de tableau 2D tabulaire d'une chaîne CSV à l'aide d'un délimiteur personnalisé. |
parseDate(date, timeZone, format) | Date | Analyse la date de chaîne fournie selon la spécification décrite dans la classe SimpleDateFormat de l'édition Java standard. |
sleep(milliseconds) | void | Mise 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 objet Blob représentant un fichier ZIP et renvoie ses fichiers composant. |
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. |
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 la forme d'un tableau d'octets.
base64Decode(encoded, charset)
Décode une chaîne encodée en base64 en tableau d'octets dans un jeu de caractères spécifique.
// This is the base64 encoded form of "Google グループ" var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw=="; var decoded = Utilities.base64Decode(base64data, Utilities.Charset.UTF_8); // This logs: // [71, 111, 111, 103, 108, 101, 32, -29, -126, -80, // -29, -125, -85, -29, -125, -68, -29, -125, -105] Logger.log(decoded); // If we want a String instead of a byte array: // This logs the original "Google グループ" Logger.log(Utilities.newBlob(decoded).getDataAsString());
Paramètres
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 la forme d'un tableau d'octets.
base64DecodeWebSafe(encoded)
Décode une chaîne encodée en base64 adaptée au Web en un tableau d'octets UTF-8.
// This is the base64 web-safe encoded form of "Google グループ" var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw=="; var decoded = Utilities.base64DecodeWebSafe(base64data); // This logs: // [71, 111, 111, 103, 108, 101, 32, -29, -126, -80, // -29, -125, -85, -29, -125, -68, -29, -125, -105] Logger.log(decoded); // If we want a String instead of a byte array: // This logs the original "Google グループ" Logger.log(Utilities.newBlob(decoded).getDataAsString());
Paramètres
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 adapté au Web sous la forme d'un tableau d'octets.
base64DecodeWebSafe(encoded, charset)
Décode une chaîne encodée en base64 Web sécurisée en un tableau d'octets dans un jeu de caractères spécifique.
// This is the base64 web-safe encoded form of "Google グループ" var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw=="; var decoded = Utilities.base64DecodeWebSafe(base64data, Utilities.Charset.UTF_8); // This logs: // [71, 111, 111, 103, 108, 101, 32, -29, -126, -80, // -29, -125, -85, -29, -125, -68, -29, -125, -105] Logger.log(decoded); // If we want a String instead of a byte array: // This logs the original "Google グループ" Logger.log(Utilities.newBlob(decoded).getDataAsString());
Paramètres
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 adapté au Web sous la forme d'un tableau d'octets.
base64Encode(data)
Génère une chaîne encodée en base64 à partir du tableau d'octets donné. La base 64 est un encodage commun accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base64 est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents XML.
// Instantiates a blob here for clarity var blob = Utilities.newBlob("A string here"); // Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64Encode(blob.getBytes()); Logger.log(encoded);
Paramètres
Nom | Type | Description |
---|---|---|
data | Byte[] | Octet[] de données à encoder. |
Renvois
String
: représentation des données transmises, encodée en base64.
base64Encode(data)
Génère une chaîne encodée en base64 à partir de la chaîne donnée. Le format base64 est un encodage courant accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base64 est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents XML.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64Encode("A string here"); Logger.log(encoded);
Paramètres
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 Charset est un moyen d'encoder des caractères de sorte qu'ils puissent l'être. Celles-ci sont généralement effectuées dans un format binaire, qui peut généralement être incompatible avec certains protocoles de transmission de données. Pour rendre les données compatibles, elles sont généralement encodées en base 64, un encodage commun accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base64 est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents XML.
// "Google Groups" in Katakana (Japanese) var input = "Google グループ"; // Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log var encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8); Logger.log(encoded);
Paramètres
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 le Charset
donné.
base64EncodeWebSafe(data)
Génère une chaîne encodée en base64 adaptée au Web à partir du tableau d'octets donné. Le format Base64 est un encodage courant accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base 64 adapté au Web est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents XML.
// Instantiates a blob here for clarity var blob = Utilities.newBlob("A string here"); // Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64EncodeWebSafe(blob.getBytes()); Logger.log(encoded);
Paramètres
Nom | Type | Description |
---|---|---|
data | Byte[] | Tableau d'octets de données à encoder. |
Renvois
String
: représentation des données transmises, encodée en base64 et adaptée au Web.
base64EncodeWebSafe(data)
Génère une chaîne encodée en base64 adaptée au Web à partir de la chaîne donnée. La base 64 est un encodage commun accepté par divers outils qui ne peuvent pas accepter les données binaires. Le format Base 64 adapté au Web est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents XML.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64EncodeWebSafe("A string here"); Logger.log(encoded);
Paramètres
Nom | Type | Description |
---|---|---|
data | String | Chaîne à encoder. |
Renvois
String
: représentation de la chaîne d'entrée, encodée en base64 et adaptée au Web.
base64EncodeWebSafe(data, charset)
Génère une chaîne encodée en base64 adaptée au Web à partir de la chaîne donnée dans un jeu de caractères spécifique. Un jeu de caractères est un moyen d'encoder des caractères de sorte qu'ils puissent l'être. Celles-ci sont généralement effectuées dans un format binaire, qui peut généralement être incompatible avec certains protocoles de transmission de données. Pour rendre les données compatibles, elles sont généralement encodées en base64, un encodage commun accepté par divers outils qui ne peuvent pas accepter les données binaires. Base 64 adapté au Web est couramment utilisé dans les protocoles Internet tels que les e-mails, HTTP ou les documents XML.
// "Google Groups" in Katakana (Japanese) var input = "Google グループ"; // Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log var encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8); Logger.log(encoded);
Paramètres
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 et encodée en base64 de la chaîne d'entrée avec le Charset
donné.
computeDigest(algorithm, value)
Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur Byte[]
spécifiée.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash") var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input); Logger.log(digest);
Paramètres
Nom | Type | Description |
---|---|---|
algorithm | DigestAlgorithm | Un 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)
Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur String
spécifiée.
var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, "input to hash"); Logger.log(digest);
Paramètres
Nom | Type | Description |
---|---|---|
algorithm | DigestAlgorithm | Un 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)
Calculez un condensé à l'aide de l'algorithme spécifié sur la valeur String
spécifiée avec le jeu de caractères indiqué.
var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, "input to hash", Utilities.Charset.US_ASCII); Logger.log(digest);
Paramètres
Nom | Type | Description |
---|---|---|
algorithm | DigestAlgorithm | Un DigestAlgorithm à utiliser. |
value | String | Valeur de chaîne d'entrée pour laquelle calculer un condensé. |
charset | Charset | Une chaîne Charset représentant le jeu de caractères d'entrée. |
Renvois
Byte[]
: octet[] représentant le condensé de sortie.
computeHmacSha256Signature(value, key)
Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé donnée.
// This writes an array of bytes to the log. var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash") var key = Utilities.base64Decode("a2V5"); // == base64encode("key") var signature = Utilities.computeHmacSha256Signature(input, key); Logger.log(signature);
Paramètres
Nom | Type | Description |
---|---|---|
value | Byte[] | Valeur d'entrée pour laquelle générer un hachage. |
key | Byte[] | Une clé à utiliser pour générer le hachage. |
Renvois
Byte[]
: octet[] représentant la signature de sortie.
computeHmacSha256Signature(value, key)
Signe la valeur fournie à l'aide de HMAC-SHA256 avec la clé donnée.
// This writes an array of bytes to the log. var signature = Utilities.computeHmacSha256Signature("this is my input", "my key - use a stronger one"); Logger.log(signature);
Paramètres
Nom | Type | Description |
---|---|---|
value | String | Valeur d'entrée pour laquelle générer un hachage. |
key | String | Une 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 | Une clé à utiliser pour générer le hachage. |
charset | Charset | Une chaîne Charset représentant le jeu de caractères d'entrée. |
Renvois
Byte[]
: octet[] représentant la signature de sortie.
computeHmacSignature(algorithm, value, key)
Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées.
// This writes an array of bytes to the log. var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash") var key = Utilities.base64Decode("a2V5"); // == base64encode("key") var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5, input, key); Logger.log(signature);
Paramètres
Nom | Type | Description |
---|---|---|
algorithm | MacAlgorithm | Un 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[] | Une clé à utiliser pour générer le hachage. |
Renvois
Byte[]
: octet[] représentant la signature de sortie.
computeHmacSignature(algorithm, value, key)
Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées.
// This writes an array of bytes to the log. var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5, "input to hash", "key"); Logger.log(signature);
Paramètres
Nom | Type | Description |
---|---|---|
algorithm | MacAlgorithm | Un 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 | Une clé à utiliser pour générer le hachage. |
Renvois
Byte[]
: octet[] représentant la signature de sortie.
computeHmacSignature(algorithm, value, key, charset)
Calculez un code d'authentification de message à l'aide de l'algorithme spécifié sur la clé et la valeur spécifiées.
// This writes an array of bytes to the log. var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5, "input to hash", "key", Utilities.Charset.US_ASCII); Logger.log(signature);
Paramètres
Nom | Type | Description |
---|---|---|
algorithm | MacAlgorithm | Un 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 | Une clé à utiliser pour générer le hachage. |
charset | Charset | Une chaîne Charset représentant le jeu de caractères d'entrée. |
Renvois
Byte[]
: octet[] représentant la signature de sortie.
computeRsaSha1Signature(value, key)
Signe la valeur fournie à l'aide de RSA-SHA1 avec la clé donnée.
// This writes an array of bytes to the log. var signature = Utilities.computeRsaSha1Signature("this is my input", "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n"); Logger.log(signature);
Paramètres
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 | Une chaîne Charset représentant le jeu de caractères d'entrée. |
Renvois
Byte[]
: octet[] représentant la signature de sortie.
computeRsaSha256Signature(value, key)
Signe la valeur fournie à l'aide de RSA-SHA256 avec la clé donnée.
// This writes an array of bytes to the log. var signature = Utilities.computeRsaSha256Signature("this is my input", "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n"); Logger.log(signature);
Paramètres
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 | Une chaîne Charset représentant le jeu de caractères d'entrée. |
Renvois
Byte[]
: octet[] représentant la signature de sortie.
computeRsaSignature(algorithm, value, key)
Signe la valeur fournie à l'aide de l'algorithme RSA spécifié avec la clé donnée.
// This writes an array of bytes to the log. var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256, "this is my input", "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n"); Logger.log(signature);
Paramètres
Nom | Type | Description |
---|---|---|
algorithm | RsaAlgorithm | Un 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. 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 | Un 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 | Une chaîne Charset représentant le jeu de caractères d'entrée. |
Renvois
Byte[]
: octet[] représentant la signature de sortie.
formatDate(date, timeZone, format)
Met en forme les dates conformément à la spécification décrite dans la classe Java SE SimpleDateFormat. Veuillez consulter la spécification à l'adresse http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html.
// This formats the date as Greenwich Mean Time in the format // year-month-dateThour-minute-second. var formattedDate = Utilities.formatDate(new Date(), "GMT", "yyyy-MM-dd'T'HH:mm:ss'Z'"); Logger.log(formattedDate);
Paramètres
Nom | Type | Description |
---|---|---|
date | Date | Un élément 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 "%".
// " 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 les éléments renvoyés. |
args | Object... | Objets à utiliser pour remplir les espaces réservés "%" dans le modèle. |
Renvois
String
: chaîne mise en forme.
getUuid()
Obtenez un UUID sous forme de chaîne (cela équivaut à l'utilisation de la méthode java.util.UUID.randomUUID()
). Il n'est pas garanti que cet identifiant soit unique pour toutes les périodes et tous les espaces. Par conséquent, ne l'utilisez pas dans les situations où l'unicité garantie est requise.
//This assigns a UUID as a temporary ID for a data object you are creating in your script. var myDataObject = { tempId: Utilities.getUuid(); };
Renvois
String
: représentation de l'UUID sous forme de chaîne.
gzip(blob)
gzip
compresse les données Blob
fournies et les renvoie dans un nouvel objet Blob
.
var textBlob = Utilities.newBlob("Some text to compress using gzip compression"); // Create the compressed blob. var gzipBlob = Utilities.gzip(textBlob);
Paramètres
Nom | Type | Description |
---|---|---|
blob | BlobSource | Un objet Blob à compresser à l'aide de gzip . |
Renvois
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
newBlob(data)
Crée un objet Blob à partir d'un tableau d'octets. Les blobs sont utilisés dans de nombreuses API Apps Script qui reçoivent des données binaires en entrée.
// Creates a blob object from a byte array. const data = [71, 79, 79, 71, 76, 69]; const blob = Utilities.newBlob(data); // Logs the blob data as a string to the console. console.log(blob.getDataAsString());
Paramètres
Nom | Type | Description |
---|---|---|
data | Byte[] | Octets de l'objet blob. |
Renvois
Blob
: objet blob nouvellement créé.
newBlob(data, contentType)
Crée un objet Blob à partir d'un tableau d'octets et d'un type de contenu. Les blobs sont utilisés dans de nombreuses API Apps Script qui acceptent des données binaires en entrée.
// Declares a byte array. const data = [71, 79, 79, 71, 76, 69]; // Declares the content type of the blob. const contentType = 'application/json'; // Creates a blob object from the byte array and content type. const blob = Utilities.newBlob(data, contentType); // Logs the blob data as a string to the console. console.log(blob.getDataAsString()); // Logs the content type of the blob to the console. console.log(blob.getContentType());
Paramètres
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 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
Nom | Type | Description |
---|---|---|
data | Byte[] | Octets de l'objet blob. |
contentType | String | : type de contenu de l'objet blob (null ). |
name | String | Le nom de l'objet blob peut être null . |
Renvois
Blob
: objet blob nouvellement créé.
newBlob(data)
Crée un objet Blob à partir d'une chaîne. Les blobs sont utilisés dans de nombreuses API Apps Script qui reçoivent des données binaires en entrée.
// Declares a string for the blob. const data = 'GOOGLE'; // Creates a blob object from a string. const blob = Utilities.newBlob(data); // Logs the blob data in byte array to the console. console.log('Blob Data:', blob.getBytes());
Paramètres
Nom | Type | Description |
---|---|---|
data | String | Chaîne de l'objet blob, supposée en UTF-8. |
Renvois
Blob
: objet blob nouvellement créé.
newBlob(data, contentType)
Créez un objet Blob à partir d'une chaîne et d'un type de contenu. Les blobs sont utilisés dans de nombreuses API Apps Script qui acceptent des données binaires en entrée.
// Declares a string for the blob. const data = 'GOOGLE'; // Declares the content type of blob. const contentType = 'application/json'; // Creates a blob object from the string and content type. const blob = Utilities.newBlob(data, contentType); // Logs the blob data in byte array to the console. console.log('Blob data:', blob.getBytes()); // Logs the content type of the blob to the console. console.log(blob.getContentType());
Paramètres
Nom | Type | Description |
---|---|---|
data | String | Chaîne de l'objet blob, supposée en UTF-8. |
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 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
Nom | Type | Description |
---|---|---|
data | String | Chaîne de l'objet blob, supposée en UTF-8. |
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 la représentation sous forme de tableau 2D d'une chaîne CSV sous forme de tableau 2D.
// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]] var csvString = "a,b,c\nd,e,f"; var data = Utilities.parseCsv(csvString);
Paramètres
Nom | Type | Description |
---|---|---|
csv | String | Chaîne contenant des données uniques ou multilignes au format CSV (valeurs séparées par des virgules). |
Renvois
String[][]
: tableau bidimensionnel contenant les valeurs de la chaîne CSV.
parseCsv(csv, delimiter)
Renvoie une représentation sous forme de tableau 2D tabulaire d'une chaîne CSV à l'aide d'un délimiteur personnalisé.
// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]] var csvString = "a\tb\tc\nd\te\tf"; var data = Utilities.parseCsv(csvString, '\t');
Paramètres
Nom | Type | Description |
---|---|---|
csv | String | Chaîne contenant des données uniques ou multilignes au format CSV (valeurs séparées par des virgules). |
delimiter | Char | Entre les valeurs. |
Renvois
String[][]
: tableau bidimensionnel contenant les valeurs de la chaîne CSV.
parseDate(date, timeZone, format)
Analyse la date de chaîne fournie selon la spécification décrite dans la classe SimpleDateFormat
de l'édition Java standard. Pour en savoir plus, consultez la section Classe SimpleDateFormat
de Java.
// This set of parameters parses the given string as a date in Greenwich Mean Time, formatted // as year-month-dateThour-minute-second. var date = Utilities.parseDate("1970-01-01 00:00:00", "GMT", "yyyy-MM-dd' 'HH:mm:ss"); Logger.log(date);
Paramètres
Nom | Type | Description |
---|---|---|
date | String | Valeur de chaîne à analyser comme 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 sous forme de date.
sleep(milliseconds)
Mise en veille pendant le nombre de millisecondes spécifié. Met immédiatement le script en veille pendant le nombre de millisecondes spécifié. La valeur maximale autorisée est de 300 000 (soit 5 minutes).
// Creates a blob object from a string. const data = 'GOOGLE'; const blob = Utilities.newBlob(data); // Puts the script to sleep for 10,000 milliseconds (10 seconds). Utilities.sleep(10000); // Logs the blob data in byte array to the console. console.log(blob.getBytes());
Paramètres
Nom | Type | Description |
---|---|---|
milliseconds | Integer | Durée de mise en veille (en millisecondes). |
ungzip(blob)
Décompresse un objet Blob
et renvoie un Blob
contenant les données non compressées.
var textBlob = Utilities.newBlob("Some text to compress using gzip compression"); // Create the compressed blob. var gzipBlob = Utilities.gzip(textBlob, "text.gz"); // Uncompress the data. var uncompressedBlob = Utilities.ungzip(gzipBlob);
Paramètres
Nom | Type | Description |
---|---|---|
blob | BlobSource | Blob de données compressées. |
Renvois
unzip(blob)
Prend un objet Blob représentant un fichier ZIP et renvoie ses fichiers composant.
var googleFavIconUrl = "https://www.google.com/favicon.ico"; var googleLogoUrl = "https://www.google.com/images/srpr/logo3w.png"; // Fetch the Google favicon.ico file and get the Blob data var faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob(); var logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob(); // zip now references a blob containing an archive of both faviconBlob and logoBlob var zip = Utilities.zip([faviconBlob, logoBlob], "google_images.zip"); // This now unzips the blobs var files = Utilities.unzip(zip);
Paramètres
Nom | Type | Description |
---|---|---|
blob | BlobSource | Blob du fichier ZIP. |
Renvois
Blob[]
: Blob[] représentant les blobs des composants, chacun nommé avec le chemin d'accès complet à l'intérieur du ZIP.
zip(blobs)
Crée un objet Blob qui est un fichier ZIP contenant les données des objets Blob transmis.
var googleFavIconUrl = "https://www.google.com/favicon.ico"; var googleLogoUrl = "https://www.google.com/images/srpr/logo3w.png"; // Fetch the Google favicon.ico file and get the Blob data var faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob(); var logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob(); // zip now references a blob containing an archive of both faviconBlob and logoBlob var zip = Utilities.zip([faviconBlob, logoBlob]);
Paramètres
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.
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.