Class Utilities

Dienstprogramme

Dieser Dienst bietet Dienstprogramme für die Stringcodierung/-decodierung, Datumsformatierung, JSON-Manipulation und verschiedene andere Aufgaben.

Attribute

AttributTypBeschreibung
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

Methoden

MethodeRückgabetypKurzbeschreibung
base64Decode(encoded)Byte[]Decodiert einen base-64-codierten String in ein UTF-8-Byte-Array.
base64Decode(encoded, charset)Byte[]Decodiert einen base-64-codierten String in ein Byte-Array in einem bestimmten Zeichensatz.
base64DecodeWebSafe(encoded)Byte[]Decodiert einen base-64 websicheren String in ein UTF-8-Byte-Array.
base64DecodeWebSafe(encoded, charset)Byte[]Decodiert einen base-64 websicheren String in ein Byte-Array in einem bestimmten Zeichensatz.
base64Encode(data)StringErstellt einen base-64-codierten String aus dem angegebenen Byte-Array.
base64Encode(data)StringErstellt einen Base-64-codierten String aus dem angegebenen String.
base64Encode(data, charset)StringErstellt einen Base-64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz.
base64EncodeWebSafe(data)StringErstellt einen base-64 websicheren codierten String aus dem angegebenen Byte-Array.
base64EncodeWebSafe(data)StringErstellt einen base-64 websicheren codierten String aus dem angegebenen String.
base64EncodeWebSafe(data, charset)StringErstellt einen base-64 websicheren String aus dem angegebenen String in einem bestimmten Zeichensatz.
computeDigest(algorithm, value)Byte[]einen Digest mit dem angegebenen Algorithmus zum angegebenen Byte[]-Wert berechnen.
computeDigest(algorithm, value)Byte[]einen Digest mit dem angegebenen Algorithmus zum angegebenen String-Wert berechnen.
computeDigest(algorithm, value, charset)Byte[]einen Digest mit dem angegebenen Algorithmus zum angegebenen String-Wert mit dem angegebenen Zeichensatz berechnen.
computeHmacSha256Signature(value, key)Byte[]Signiert den bereitgestellten Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel.
computeHmacSha256Signature(value, key)Byte[]Signiert den bereitgestellten Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel.
computeHmacSha256Signature(value, key, charset)Byte[]Signiert den bereitgestellten Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel und Zeichensatz.
computeHmacSignature(algorithm, value, key)Byte[]Berechnet einen Nachrichtenauthentifizierungscode mit dem angegebenen Algorithmus für den angegebenen Schlüssel und Wert.
computeHmacSignature(algorithm, value, key)Byte[]Berechnet einen Nachrichtenauthentifizierungscode mit dem angegebenen Algorithmus für den angegebenen Schlüssel und Wert.
computeHmacSignature(algorithm, value, key, charset)Byte[]Berechnet einen Nachrichtenauthentifizierungscode mit dem angegebenen Algorithmus für den angegebenen Schlüssel und Wert.
computeRsaSha1Signature(value, key)Byte[]Signiert den bereitgestellten Wert mithilfe von RSA-SHA1 mit dem angegebenen Schlüssel.
computeRsaSha1Signature(value, key, charset)Byte[]Signiert den bereitgestellten Wert mithilfe von RSA-SHA1 mit dem angegebenen Schlüssel und Zeichensatz.
computeRsaSha256Signature(value, key)Byte[]Signiert den bereitgestellten Wert mithilfe von RSA-SHA256 mit dem angegebenen Schlüssel.
computeRsaSha256Signature(value, key, charset)Byte[]Signiert den bereitgestellten Wert mithilfe von RSA-SHA256 mit dem angegebenen Schlüssel.
computeRsaSignature(algorithm, value, key)Byte[]Signiert den bereitgestellten Wert mithilfe des angegebenen RSA-Algorithmus mit dem angegebenen Schlüssel.
computeRsaSignature(algorithm, value, key, charset)Byte[]Signiert den bereitgestellten Wert mithilfe des angegebenen RSA-Algorithmus mit dem angegebenen Schlüssel und Zeichensatz.
formatDate(date, timeZone, format)StringFormatiert das Datum gemäß der Spezifikation in der Java-Klasse SE SimpleDateFormat.
formatString(template, args)StringFührt eine sprintf-ähnliche Stringformatierung mit '%'-Formatstrings durch.
getUuid()StringRufen Sie eine UUID als String ab (entspricht der Verwendung der Methode java.util.UUID.randomUUID()).
gzip(blob)Blobgzip komprimiert die bereitgestellten Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück.
gzip(blob, name)Blobgzip komprimiert die bereitgestellten Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück.
newBlob(data)BlobErstellen Sie ein neues Blob-Objekt aus einem Byte-Array.
newBlob(data, contentType)BlobErstellt ein neues Blob-Objekt aus einem Byte-Array und einem Inhaltstyp.
newBlob(data, contentType, name)BlobErstellt ein neues Blob-Objekt aus einem Byte-Array, einem Inhaltstyp und einem Namen.
newBlob(data)BlobErstellt ein neues Blob-Objekt aus einem String.
newBlob(data, contentType)BlobErstellen Sie ein neues Blob-Objekt aus einem String und einem Inhaltstyp.
newBlob(data, contentType, name)BlobErstellt ein neues Blob-Objekt aus einem String, einem Inhaltstyp und einem Namen.
parseCsv(csv)String[][]Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings zurück.
parseCsv(csv, delimiter)String[][]Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings mit einem benutzerdefinierten Trennzeichen zurück.
parseDate(date, timeZone, format)DateParst das angegebene String-Datum gemäß der Spezifikation, die in der Java Standard Edition-Klasse SimpleDateFormat beschrieben wird.
sleep(milliseconds)voidRuhemodus für die angegebene Anzahl von Millisekunden.
ungzip(blob)BlobDekomprimiert ein Blob-Objekt und gibt ein Blob mit den unkomprimierten Daten zurück.
unzip(blob)Blob[]Ruft ein Blob ab, das eine ZIP-Datei darstellt, und gibt seine Komponentendateien zurück.
zip(blobs)BlobErstellt ein neues Blob-Objekt, das eine ZIP-Datei ist, die die Daten aus den übergebenen Blobs enthält.
zip(blobs, name)BlobErstellt ein neues Blob-Objekt, das eine ZIP-Datei ist, die die Daten aus den übergebenen Blobs enthält.

Detaillierte Dokumentation

base64Decode(encoded)

Decodiert einen base-64-codierten String in ein UTF-8-Byte-Array.

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

Parameter

NameTypBeschreibung
encodedStringein Array von Bytes mit Daten, die decodiert werden sollen

Zurücksenden

Byte[]: Die Rohdaten, die durch das base-64-codierte Argument dargestellt werden, als Byte-Array


base64Decode(encoded, charset)

Decodiert einen base-64-codierten String in ein Byte-Array in einem bestimmten Zeichensatz.

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

Parameter

NameTypBeschreibung
encodedStringString der zu decodierenden Daten
charsetCharsetEin Charset, der den Zeichensatz der Eingabe angibt

Zurücksenden

Byte[]: Die Rohdaten, die durch das base-64-codierte Argument dargestellt werden, als Byte-Array


base64DecodeWebSafe(encoded)

Decodiert einen base-64 websicheren String in ein UTF-8-Byte-Array.

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

Parameter

NameTypBeschreibung
encodedStringein Array von websicheren Byte zum Decodieren

Zurücksenden

Byte[]: Die Rohdaten, die durch das websichere codierte Base-64-Argument als Byte-Array dargestellt werden


base64DecodeWebSafe(encoded, charset)

Decodiert einen base-64 websicheren String in ein Byte-Array in einem bestimmten Zeichensatz.

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

Parameter

NameTypBeschreibung
encodedStringString der websicheren Daten, die decodiert werden sollen
charsetCharsetEin Charset, der den Zeichensatz der Eingabe angibt

Zurücksenden

Byte[]: Die Rohdaten, die durch das websichere codierte Base-64-Argument als Byte-Array dargestellt werden


base64Encode(data)

Erstellt einen base-64-codierten String aus dem angegebenen Byte-Array. Base 64 ist eine allgemeine Codierung, die von verschiedenen Tools akzeptiert wird, die keine Binärdaten akzeptieren können. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder XML-Dokumenten verwendet.

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

Parameter

NameTypBeschreibung
dataByte[]Ein Byte[] für die Codierung von Daten

Zurücksenden

String: Die Base64-codierte Darstellung der übergebenen Daten.


base64Encode(data)

Erstellt einen Base-64-codierten String aus dem angegebenen String. Base 64 ist eine allgemeine Codierung, die von verschiedenen Tools akzeptiert wird, die keine Binärdaten akzeptieren können. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder XML-Dokumenten verwendet.

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

Parameter

NameTypBeschreibung
dataStringString, der codiert werden soll

Zurücksenden

String: Die Base64-codierte Darstellung des Eingabestrings.


base64Encode(data, charset)

Erstellt einen Base-64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz. Ein Charset ist eine Möglichkeit, Zeichen so zu codieren, dass sie codiert werden können. Diese werden normalerweise in einem Binärformat ausgeführt, das im Allgemeinen mit bestimmten Datenübertragungsprotokollen nicht kompatibel ist. Um die Daten kompatibel zu machen, werden sie normalerweise in Base 64 codiert. Dies ist eine gängige Codierung, die von verschiedenen Tools akzeptiert wird, die keine Binärdaten akzeptieren können. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder XML-Dokumenten verwendet.

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

Parameter

NameTypBeschreibung
dataStringString der zu codierenden Daten
charsetCharsetEin Charset, der den Zeichensatz der Eingabe angibt

Zurücksenden

String: Die Base64-codierte Darstellung des Eingabestrings mit dem angegebenen Charset.


base64EncodeWebSafe(data)

Erstellt einen base-64 websicheren codierten String aus dem angegebenen Byte-Array. Base 64 ist eine allgemeine Codierung, die von verschiedenen Tools akzeptiert wird, die keine Binärdaten akzeptieren können. Base 64 websicher wird häufig in Internetprotokollen wie E-Mail, HTTP oder XML-Dokumenten verwendet.

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

Parameter

NameTypBeschreibung
dataByte[]ein Array von Bytes mit Daten, die codiert werden sollen

Zurücksenden

String: Die base-64 websichere codierte Darstellung der übergebenen Daten.


base64EncodeWebSafe(data)

Erstellt einen base-64 websicheren codierten String aus dem angegebenen String. Base 64 ist eine allgemeine Codierung, die von verschiedenen Tools akzeptiert wird, die keine Binärdaten akzeptieren können. Base 64 websicher wird häufig in Internetprotokollen wie E-Mails, HTTP oder XML-Dokumenten verwendet.

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

Parameter

NameTypBeschreibung
dataStringString, der codiert werden soll

Zurücksenden

String: Die websichere codierte Base-64-Darstellung des Eingabestrings.


base64EncodeWebSafe(data, charset)

Erstellt einen base-64 websicheren String aus dem angegebenen String in einem bestimmten Zeichensatz. Ein Charset ist eine Möglichkeit, Zeichen so zu codieren, dass sie codiert werden können. Diese werden normalerweise in einem Binärformat ausgeführt, das im Allgemeinen mit bestimmten Datenübertragungsprotokollen nicht kompatibel ist. Um die Daten kompatibel zu machen, werden sie normalerweise in Base 64 codiert. Dies ist eine gängige Codierung, die von verschiedenen Tools akzeptiert wird, die keine Binärdaten akzeptieren. Base 64 websicher wird häufig in Internetprotokollen wie E-Mail, HTTP oder XML-Dokumenten verwendet.

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

Parameter

NameTypBeschreibung
dataStringString der zu codierenden Daten
charsetCharsetEin Charset, der den Zeichensatz der Eingabe angibt

Zurücksenden

String: Die Base-64-codierte Webdarstellung des Eingabestrings mit dem angegebenen Charset.


computeDigest(algorithm, value)

einen Digest mit dem angegebenen Algorithmus zum angegebenen Byte[]-Wert berechnen.

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

Parameter

NameTypBeschreibung
algorithmDigestAlgorithmDigestAlgorithm zu verwenden
valueByte[]Eingabestringwert, für den ein Digest berechnet wird

Zurücksenden

Byte[]: Ein Byte[], das den Ausgabe-Digest darstellt


computeDigest(algorithm, value)

einen Digest mit dem angegebenen Algorithmus zum angegebenen String-Wert berechnen.

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

Parameter

NameTypBeschreibung
algorithmDigestAlgorithmDigestAlgorithm zu verwenden
valueStringEingabestringwert, für den ein Digest berechnet wird

Zurücksenden

Byte[]: Ein Byte[], das den Ausgabe-Digest darstellt


computeDigest(algorithm, value, charset)

einen Digest mit dem angegebenen Algorithmus zum angegebenen String-Wert mit dem angegebenen Zeichensatz berechnen.

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

Parameter

NameTypBeschreibung
algorithmDigestAlgorithmDigestAlgorithm zu verwenden
valueStringEingabestringwert, für den ein Digest berechnet wird
charsetCharsetein Charset, der den Eingabezeichensatz darstellt

Zurücksenden

Byte[]: Ein Byte[], das den Ausgabe-Digest darstellt


computeHmacSha256Signature(value, key)

Signiert den bereitgestellten Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel.

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

Parameter

NameTypBeschreibung
valueByte[]Eingabewert, für den ein Hash generiert werden soll
keyByte[]einen Schlüssel zum Generieren des Hashwerts mit

Zurücksenden

Byte[]: ein Byte[] für die Ausgabesignatur


computeHmacSha256Signature(value, key)

Signiert den bereitgestellten Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel.

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

Parameter

NameTypBeschreibung
valueStringEingabewert, für den ein Hash generiert werden soll
keyStringeinen Schlüssel zum Generieren des Hashwerts mit

Zurücksenden

Byte[]: ein Byte[] für die Ausgabesignatur


computeHmacSha256Signature(value, key, charset)

Signiert den bereitgestellten Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel und Zeichensatz.

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

Parameter

NameTypBeschreibung
valueStringEingabewert, für den ein Hash generiert werden soll
keyStringeinen Schlüssel zum Generieren des Hashwerts mit
charsetCharsetein Charset, der den Eingabezeichensatz darstellt

Zurücksenden

Byte[]: ein Byte[] für die Ausgabesignatur


computeHmacSignature(algorithm, value, key)

Berechnet einen Nachrichtenauthentifizierungscode mit dem angegebenen Algorithmus für den angegebenen Schlüssel und Wert.

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

Parameter

NameTypBeschreibung
algorithmMacAlgorithmEin MacAlgorithm-Algorithmus zum Hashen des Eingabewerts
valueByte[]Eingabewert, für den ein Hash generiert werden soll
keyByte[]einen Schlüssel zum Generieren des Hashwerts mit

Zurücksenden

Byte[]: ein Byte[] für die Ausgabesignatur


computeHmacSignature(algorithm, value, key)

Berechnet einen Nachrichtenauthentifizierungscode mit dem angegebenen Algorithmus für den angegebenen Schlüssel und Wert.

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

Parameter

NameTypBeschreibung
algorithmMacAlgorithmEin MacAlgorithm-Algorithmus zum Hashen des Eingabewerts
valueStringEingabewert, für den ein Hash generiert werden soll
keyStringeinen Schlüssel zum Generieren des Hashwerts mit

Zurücksenden

Byte[]: ein Byte[] für die Ausgabesignatur


computeHmacSignature(algorithm, value, key, charset)

Berechnet einen Nachrichtenauthentifizierungscode mit dem angegebenen Algorithmus für den angegebenen Schlüssel und Wert.

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

Parameter

NameTypBeschreibung
algorithmMacAlgorithmEin MacAlgorithm-Algorithmus zum Hashen des Eingabewerts
valueStringEingabewert, für den ein Hash generiert werden soll
keyStringeinen Schlüssel zum Generieren des Hashwerts mit
charsetCharsetein Charset, der den Eingabezeichensatz darstellt

Zurücksenden

Byte[]: ein Byte[] für die Ausgabesignatur


computeRsaSha1Signature(value, key)

Signiert den bereitgestellten Wert mithilfe von RSA-SHA1 mit dem angegebenen Schlüssel.

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

Parameter

NameTypBeschreibung
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.

Zurücksenden

Byte[]: Ein Byte[] für die Ausgabesignatur.


computeRsaSha1Signature(value, key, charset)

Signiert den bereitgestellten Wert mithilfe von RSA-SHA1 mit dem angegebenen Schlüssel und Zeichensatz.

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

Parameter

NameTypBeschreibung
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.
charsetCharsetEin Charset, der den Eingabezeichensatz darstellt.

Zurücksenden

Byte[]: Ein Byte[] für die Ausgabesignatur.


computeRsaSha256Signature(value, key)

Signiert den bereitgestellten Wert mithilfe von RSA-SHA256 mit dem angegebenen Schlüssel.

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

Parameter

NameTypBeschreibung
valueStringEingabewert, für den ein Hash generiert werden soll
keyStringEin PEM-formatierter Schlüssel zum Generieren der Signatur

Zurücksenden

Byte[]: ein Byte[] für die Ausgabesignatur


computeRsaSha256Signature(value, key, charset)

Signiert den bereitgestellten Wert mithilfe von RSA-SHA256 mit dem angegebenen Schlüssel.

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

Parameter

NameTypBeschreibung
valueStringEingabewert, für den ein Hash generiert werden soll
keyStringEin PEM-formatierter Schlüssel zum Generieren der Signatur
charsetCharsetein Charset, der den Eingabezeichensatz darstellt

Zurücksenden

Byte[]: ein Byte[] für die Ausgabesignatur


computeRsaSignature(algorithm, value, key)

Signiert den bereitgestellten Wert mithilfe des angegebenen RSA-Algorithmus mit dem angegebenen Schlüssel.

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

Parameter

NameTypBeschreibung
algorithmRsaAlgorithmEin RsaAlgorithm-Algorithmus zum Hashen des Eingabewerts.
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.

Zurücksenden

Byte[]: Ein Byte[] für die Ausgabesignatur.


computeRsaSignature(algorithm, value, key, charset)

Signiert den bereitgestellten Wert mithilfe des angegebenen RSA-Algorithmus mit dem angegebenen Schlüssel und Zeichensatz.

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

Parameter

NameTypBeschreibung
algorithmRsaAlgorithmEin RsaAlgorithm-Algorithmus zum Hashen des Eingabewerts.
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.
charsetCharsetEin Charset, der den Eingabezeichensatz darstellt.

Zurücksenden

Byte[]: Ein Byte[] für die Ausgabesignatur.


formatDate(date, timeZone, format)

Formatiert das Datum gemäß der Spezifikation in der Java-Klasse SE SimpleDateFormat. Die Spezifikation finden Sie unter 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);

Parameter

NameTypBeschreibung
dateDateEin Date zur Formatierung als String
timeZoneStringAusgabezeitzone des Ergebnisses
formatStringein Format gemäß der SimpleDateFormat-Spezifikation

Zurücksenden

String: Das Eingabedatum als formatierter String.


formatString(template, args)

Führt eine sprintf-ähnliche Stringformatierung mit '%'-Formatstrings durch.

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

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

Parameter

NameTypBeschreibung
templateStringFormatstring, der steuert, was zurückgegeben wird.
argsObject...Objekte, die in der Vorlage für die Platzhalter verwendet werden sollen.

Zurücksenden

String: Der formatierte String.


getUuid()

Rufen Sie eine UUID als String ab (entspricht der Verwendung der Methode java.util.UUID.randomUUID()). Es ist nicht garantiert, dass diese Kennzeichnung in Bezug auf Zeit und Space eindeutig ist. Verwenden Sie sie daher nicht in Situationen, in denen garantierte Eindeutigkeit erforderlich ist.

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

Zurücksenden

String: Eine Stringdarstellung der UUID.


gzip(blob)

gzip komprimiert die bereitgestellten Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück.

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

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

Parameter

NameTypBeschreibung
blobBlobSourceEin Blob-Objekt, das mit gzip komprimiert werden soll.

Zurücksenden

Blob: Ein neuer Blob mit den komprimierten Daten.


gzip(blob, name)

gzip komprimiert die bereitgestellten Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück. In dieser Version der Methode kann ein Dateiname angegeben werden.

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

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

Parameter

NameTypBeschreibung
blobBlobSourceEin Blob-Objekt, das mit gzip komprimiert werden soll.
nameStringName der gzip-Datei, die erstellt werden soll

Zurücksenden

Blob: Ein neuer Blob mit den komprimierten Daten.


newBlob(data)

Erstellen Sie ein neues Blob-Objekt aus einem Byte-Array. Blobs werden in vielen Apps Script APIs verwendet, die Binärdaten als Eingabe verarbeiten.

Parameter

NameTypBeschreibung
dataByte[]die Byte für das Blob

Zurücksenden

Blob: Der neu erstellte Blob


newBlob(data, contentType)

Erstellt ein neues Blob-Objekt aus einem Byte-Array und einem Inhaltstyp. Blobs werden in vielen Apps Script APIs verwendet, die Binärdaten als Eingabe verarbeiten.

Parameter

NameTypBeschreibung
dataByte[]die Byte für das Blob
contentTypeStringInhaltstyp des Blobs – kann null sein

Zurücksenden

Blob: Der neu erstellte Blob


newBlob(data, contentType, name)

Erstellt ein neues Blob-Objekt aus einem Byte-Array, einem Inhaltstyp und einem Namen. Blobs werden in vielen Apps Script APIs verwendet, die Binärdaten als Eingabe verarbeiten.

Parameter

NameTypBeschreibung
dataByte[]die Byte für das Blob
contentTypeString– Inhaltstyp des Blobs – kann null sein
nameStringName des Blobs – kann null sein

Zurücksenden

Blob: Der neu erstellte Blob


newBlob(data)

Erstellt ein neues Blob-Objekt aus einem String. Blobs werden in vielen Apps Script APIs verwendet, die Binärdaten als Eingabe verarbeiten.

Parameter

NameTypBeschreibung
dataStringString für das Blob, angenommen UTF-8

Zurücksenden

Blob: Der neu erstellte Blob


newBlob(data, contentType)

Erstellen Sie ein neues Blob-Objekt aus einem String und einem Inhaltstyp. Blobs werden in vielen Apps Script APIs verwendet, die Binärdaten als Eingabe verarbeiten.

Parameter

NameTypBeschreibung
dataStringString für das Blob, angenommen UTF-8
contentTypeStringInhaltstyp des Blobs – kann null sein

Zurücksenden

Blob: Der neu erstellte Blob


newBlob(data, contentType, name)

Erstellt ein neues Blob-Objekt aus einem String, einem Inhaltstyp und einem Namen. Blobs werden in vielen Apps Script APIs verwendet, die Binärdaten als Eingabe verarbeiten.

Parameter

NameTypBeschreibung
dataStringString für das Blob, angenommen UTF-8
contentTypeStringInhaltstyp des Blobs – kann null sein
nameStringName des Blobs – kann null sein

Zurücksenden

Blob: Der neu erstellte Blob


parseCsv(csv)

Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings zurück.

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

Parameter

NameTypBeschreibung
csvStringEin String, der ein- oder mehrzeilige Daten im CSV-Format enthält.

Zurücksenden

String[][]: ein zweidimensionales Array, das die Werte im CSV-String enthält


parseCsv(csv, delimiter)

Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings mit einem benutzerdefinierten Trennzeichen zurück.

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

Parameter

NameTypBeschreibung
csvStringEin String, der ein- oder mehrzeilige Daten im CSV-Format enthält.
delimiterCharzwischen Werten

Zurücksenden

String[][]: ein zweidimensionales Array, das die Werte im CSV-String enthält


parseDate(date, timeZone, format)

Parst das angegebene String-Datum gemäß der Spezifikation, die in der Java Standard Edition-Klasse SimpleDateFormat beschrieben wird. Weitere Informationen finden Sie in der Java-SimpleDateFormat-Klasse.

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

Parameter

NameTypBeschreibung
dateStringEin Stringwert, der als Datum geparst werden soll.
timeZoneStringDie Zeitzone der Ausgabe.
formatStringDas Datumsformat gemäß der SimpleDateFormat-Spezifikation.

Zurücksenden

Date: Der Eingabestring als Datum.


sleep(milliseconds)

Ruhemodus für die angegebene Anzahl von Millisekunden. Das Skript wird nach der festgelegten Anzahl von Millisekunden sofort in den Ruhemodus versetzt. Der maximal zulässige Wert ist 300.000 (oder 5 Minuten).

Parameter

NameTypBeschreibung
millisecondsIntegerDie Anzahl der Millisekunden für den Ruhemodus.

ungzip(blob)

Dekomprimiert ein Blob-Objekt und gibt ein Blob mit den unkomprimierten Daten zurück.

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

Parameter

NameTypBeschreibung
blobBlobSourceBlob der komprimierten Daten.

Zurücksenden

Blob: Ein Blob für die dekomprimierten Daten.


unzip(blob)

Ruft ein Blob ab, das eine ZIP-Datei darstellt, und gibt seine Komponentendateien zurück.

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

Parameter

NameTypBeschreibung
blobBlobSourcein der ZIP-Datei.

Zurücksenden

Blob[]: Ein Blob[], das die Komponenten-Blobs darstellt, die jeweils mit dem vollständigen Pfad in der ZIP-Datei benannt sind


zip(blobs)

Erstellt ein neues Blob-Objekt, das eine ZIP-Datei ist, die die Daten aus den übergebenen Blobs enthält.

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

Parameter

NameTypBeschreibung
blobsBlobSource[]ein Array von Blobs, das komprimiert werden soll

Zurücksenden

Blob: Ein neues Blob mit den Eingaben als Archiv.


zip(blobs, name)

Erstellt ein neues Blob-Objekt, das eine ZIP-Datei ist, die die Daten aus den übergebenen Blobs enthält. In dieser Version der Methode kann ein Dateiname angegeben werden.

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

Parameter

NameTypBeschreibung
blobsBlobSource[]ein Array von Blobs, das komprimiert werden soll
nameStringDen Namen der zu erstellenden ZIP-Datei

Zurücksenden

Blob: Ein neues Blob mit den Eingaben als Archiv.

Eingestellte Methoden