Dieser Dienst bietet Dienstprogramme für die Codierung/Decodierung von Strings, die Datumsformatierung, JSON-Bearbeitung und andere Aufgaben.
Attribute
Property | Typ | Beschreibung |
---|---|---|
Charset | Charset | |
DigestAlgorithm | DigestAlgorithm | |
MacAlgorithm | MacAlgorithm | |
RsaAlgorithm | RsaAlgorithm |
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
base64Decode(encoded) | Byte[] | Decodiert einen base64-codierten String in ein UTF-8-Byte-Array. |
base64Decode(encoded, charset) | Byte[] | Decodiert einen base64-codierten String in ein Bytearray in einem bestimmten Zeichensatz. |
base64DecodeWebSafe(encoded) | Byte[] | Decodiert einen websicheren, base-64-codierten String in ein UTF-8-Byte-Array. |
base64DecodeWebSafe(encoded, charset) | Byte[] | Decodiert einen websicheren, base-64-codierten String in ein Byte-Array in einem bestimmten Zeichensatz. |
base64Encode(data) | String | Erzeugt einen base64-codierten String aus dem gegebenen Byte-Array. |
base64Encode(data) | String | Erzeugt einen base-64-codierten String aus dem angegebenen String. |
base64Encode(data, charset) | String | Erzeugt einen base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz. |
base64EncodeWebSafe(data) | String | Generiert einen websicheren base64-codierten String aus dem angegebenen Byte-Array. |
base64EncodeWebSafe(data) | String | Generiert einen websicheren base64-codierten String aus dem angegebenen String. |
base64EncodeWebSafe(data, charset) | String | Erzeugt einen websicheren base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz. |
computeDigest(algorithm, value) | Byte[] | Berechnet mit dem angegebenen Algorithmus einen Digest für den angegebenen Byte[] -Wert. |
computeDigest(algorithm, value) | Byte[] | Berechnet mit dem angegebenen Algorithmus einen Digest für den angegebenen String -Wert. |
computeDigest(algorithm, value, charset) | Byte[] | Berechnet mit dem angegebenen Algorithmus einen Digest für den angegebenen String -Wert mit dem angegebenen Zeichensatz. |
computeHmacSha256Signature(value, key) | Byte[] | Signiert den angegebenen Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel. |
computeHmacSha256Signature(value, key) | Byte[] | Signiert den angegebenen Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel. |
computeHmacSha256Signature(value, key, charset) | Byte[] | Signiert den angegebenen Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel und Zeichensatz. |
computeHmacSignature(algorithm, value, key) | Byte[] | Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode für den angegebenen Schlüssel und Wert. |
computeHmacSignature(algorithm, value, key) | Byte[] | Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode für den angegebenen Schlüssel und Wert. |
computeHmacSignature(algorithm, value, key, charset) | Byte[] | Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode für den angegebenen Schlüssel und Wert. |
computeRsaSha1Signature(value, key) | Byte[] | Signiert den angegebenen Wert mit RSA-SHA1 mit dem angegebenen Schlüssel. |
computeRsaSha1Signature(value, key, charset) | Byte[] | Signiert den angegebenen Wert mit RSA-SHA1 mit dem angegebenen Schlüssel und Zeichensatz. |
computeRsaSha256Signature(value, key) | Byte[] | Signiert den angegebenen Wert mit RSA-SHA256 mit dem angegebenen Schlüssel. |
computeRsaSha256Signature(value, key, charset) | Byte[] | Signiert den angegebenen Wert mit RSA-SHA256 mit dem angegebenen Schlüssel. |
computeRsaSignature(algorithm, value, key) | Byte[] | Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus mit dem angegebenen Schlüssel. |
computeRsaSignature(algorithm, value, key, charset) | Byte[] | Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus mit dem angegebenen Schlüssel und Zeichensatz. |
formatDate(date, timeZone, format) | String | Formatiert Datum gemäß der in der Java SE SimpleDateFormat-Klasse beschriebenen Spezifikation. |
formatString(template, args) | String | Führt eine sprintf -ähnliche Stringformatierung mit Formatstrings im „%“-Stil durch. |
getUuid() | String | Rufen Sie eine UUID als String ab (entspricht der Verwendung der Methode java.util.UUID.randomUUID() ). |
gzip(blob) | Blob | gzip komprimiert die bereitgestellten Blob -Daten und gibt sie in einem neuen Blob -Objekt zurück. |
gzip(blob, name) | Blob | gzip komprimiert die bereitgestellten Blob -Daten und gibt sie in einem neuen Blob -Objekt zurück. |
newBlob(data) | Blob | Erstellt ein neues Blob-Objekt aus einem Byte-Array. |
newBlob(data, contentType) | Blob | Erstellt ein neues Blob-Objekt aus einem Byte-Array und einem Inhaltstyp. |
newBlob(data, contentType, name) | Blob | Erstellt ein neues Blob-Objekt aus einem Byte-Array, einem Inhaltstyp und einem Namen. |
newBlob(data) | Blob | Erstellt ein neues Blob-Objekt aus einem String. |
newBlob(data, contentType) | Blob | Erstellt ein neues Blob-Objekt aus einem String und Inhaltstyp. |
newBlob(data, contentType, name) | Blob | Erstellt 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 unter Verwendung eines benutzerdefinierten Trennzeichens zurück. |
parseDate(date, timeZone, format) | Date | Analysiert das angegebene Stringdatum gemäß der Spezifikation, die in der SimpleDateFormat -Klasse der Java Standard Edition beschrieben ist. |
sleep(milliseconds) | void | Schlaft für eine bestimmte Anzahl von Millisekunden. |
ungzip(blob) | Blob | Dekomprimiert ein Blob -Objekt und gibt ein Blob -Objekt mit den unkomprimierten Daten zurück. |
unzip(blob) | Blob[] | Nimmt einen Blob, der eine ZIP-Datei darstellt, und gibt deren Komponentendateien zurück. |
zip(blobs) | Blob | Erstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei handelt, die die Daten aus den übergebenen Blobs enthält. |
zip(blobs, name) | Blob | Erstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei handelt, die die Daten aus den übergebenen Blobs enthält. |
Detaillierte Dokumentation
base64Decode(encoded)
Decodiert einen base64-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
Name | Typ | Beschreibung |
---|---|---|
encoded | String | Ein Array von Datenbyte, die decodiert werden sollen. |
Return
Byte[]
: Die Rohdaten, die durch das base-64-codierte Argument als Byte-Array dargestellt werden.
base64Decode(encoded, charset)
Decodiert einen base64-codierten String in ein Bytearray 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
Name | Typ | Beschreibung |
---|---|---|
encoded | String | Die zu decodierende Datenzeichenfolge. |
charset | Charset | Ein Charset , der den Zeichensatz der Eingabe angibt. |
Return
Byte[]
: Die Rohdaten, die durch das base-64-codierte Argument als Byte-Array dargestellt werden.
base64DecodeWebSafe(encoded)
Decodiert einen websicheren, base-64-codierten 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
Name | Typ | Beschreibung |
---|---|---|
encoded | String | Ein Array von Bytes aus websicheren Daten, die decodiert werden sollen. |
Return
Byte[]
: Die Rohdaten, die durch das base-64-Websicher-codierte Argument als Byte-Array dargestellt werden.
base64DecodeWebSafe(encoded, charset)
Decodiert einen websicheren, base-64-codierten 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
Name | Typ | Beschreibung |
---|---|---|
encoded | String | Zeichenfolge aus websicheren Daten, die decodiert werden sollen. |
charset | Charset | Ein Charset , der den Zeichensatz der Eingabe angibt. |
Return
Byte[]
: Die Rohdaten, die durch das base-64-Websicher-codierte Argument als Byte-Array dargestellt werden.
base64Encode(data)
Erzeugt einen base64-codierten String aus dem gegebenen Byte-Array. Base64 ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten annehmen können. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder in 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
Name | Typ | Beschreibung |
---|---|---|
data | Byte[] | Ein Byte[] mit zu codierenden Daten. |
Return
String
: Die base64-codierte Darstellung der übergebenen Daten.
base64Encode(data)
Erzeugt einen base-64-codierten String aus dem angegebenen String. Base64 ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten annehmen können. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64Encode("A string here"); Logger.log(encoded);
Parameter
Name | Typ | Beschreibung |
---|---|---|
data | String | Entspricht der zu codierenden Zeichenfolge. |
Return
String
: Die base64-codierte Darstellung des Eingabestrings.
base64Encode(data, charset)
Erzeugt einen base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz. Mit einem Charset können Zeichen so codiert werden, dass sie codiert werden können. Diese werden normalerweise in einem Binärformat ausgeführt, das im Allgemeinen mit bestimmten Datenübertragungsprotokollen nicht kompatibel sein kann. Um die Daten kompatibel zu machen, werden sie im Allgemeinen in Base 64 codiert, eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten annehmen können. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder in 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
Name | Typ | Beschreibung |
---|---|---|
data | String | Die zu codierende Datenzeichenfolge. |
charset | Charset | Ein Charset , der den Zeichensatz der Eingabe angibt. |
Return
String
: Die base64-codierte Darstellung des Eingabestrings mit dem angegebenen Charset
.
base64EncodeWebSafe(data)
Generiert einen websicheren base64-codierten String aus dem angegebenen Byte-Array. Base 64 ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten annehmen können. Base64 websicher wird häufig in Internetprotokollen wie E-Mail, HTTP oder in 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
Name | Typ | Beschreibung |
---|---|---|
data | Byte[] | Ein Array von Datenbyte, die codiert werden sollen. |
Return
String
: Die websichere base64-codierte Darstellung der übergebenen Daten.
base64EncodeWebSafe(data)
Generiert einen websicheren base64-codierten String aus dem angegebenen String. Base64 ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten annehmen können. Base64 websicher wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64EncodeWebSafe("A string here"); Logger.log(encoded);
Parameter
Name | Typ | Beschreibung |
---|---|---|
data | String | Entspricht der zu codierenden Zeichenfolge. |
Return
String
: Die websicher codierte Darstellung des Eingabestrings mit Base64.
base64EncodeWebSafe(data, charset)
Erzeugt einen websicheren base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz. Mit einem Charset können Zeichen so codiert werden, dass sie codiert werden können. Sie werden in der Regel in einem Binärformat erstellt, das im Allgemeinen mit bestimmten Datenübertragungsprotokollen nicht kompatibel sein kann. Um die Daten kompatibel zu machen, werden sie im Allgemeinen in Base 64 codiert. Diese Codierung wird häufig von einer Vielzahl von Tools akzeptiert, die keine Binärdaten annehmen können. Base 64 websicher wird häufig in Internetprotokollen wie E-Mail, HTTP oder in 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
Name | Typ | Beschreibung |
---|---|---|
data | String | Die zu codierende Datenzeichenfolge. |
charset | Charset | Ein Charset , der den Zeichensatz der Eingabe angibt. |
Return
String
: Die websichere Base64-codierte Darstellung des Eingabestrings mit dem angegebenen Charset
.
computeDigest(algorithm, value)
Berechnet mit dem angegebenen Algorithmus einen Digest für den angegebenen Byte[]
-Wert.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash") var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input); Logger.log(digest);
Parameter
Name | Typ | Beschreibung |
---|---|---|
algorithm | DigestAlgorithm | Ein zu verwendendes DigestAlgorithm . |
value | Byte[] | Ein Eingabestringwert, für den ein Digest berechnet werden soll. |
Return
Byte[]
: Ein Byte[], das den Ausgabe-Digest darstellt.
computeDigest(algorithm, value)
Berechnet mit dem angegebenen Algorithmus einen Digest für den angegebenen String
-Wert.
var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, "input to hash"); Logger.log(digest);
Parameter
Name | Typ | Beschreibung |
---|---|---|
algorithm | DigestAlgorithm | Ein zu verwendendes DigestAlgorithm . |
value | String | Ein Eingabestringwert, für den ein Digest berechnet werden soll. |
Return
Byte[]
: Ein Byte[], das den Ausgabe-Digest darstellt.
computeDigest(algorithm, value, charset)
Berechnet mit dem angegebenen Algorithmus einen Digest für den angegebenen String
-Wert mit dem angegebenen Zeichensatz.
var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, "input to hash", Utilities.Charset.US_ASCII); Logger.log(digest);
Parameter
Name | Typ | Beschreibung |
---|---|---|
algorithm | DigestAlgorithm | Ein zu verwendendes DigestAlgorithm . |
value | String | Ein Eingabestringwert, für den ein Digest berechnet werden soll. |
charset | Charset | Ein Charset , der den Eingabezeichensatz darstellt. |
Return
Byte[]
: Ein Byte[], das den Ausgabe-Digest darstellt.
computeHmacSha256Signature(value, key)
Signiert den angegebenen 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
Name | Typ | Beschreibung |
---|---|---|
value | Byte[] | Der Eingabewert, für den ein Hash generiert werden soll. |
key | Byte[] | Ein Schlüssel, mit dem der Hash generiert wird. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeHmacSha256Signature(value, key)
Signiert den angegebenen 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
Name | Typ | Beschreibung |
---|---|---|
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel, mit dem der Hash generiert wird. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeHmacSha256Signature(value, key, charset)
Signiert den angegebenen 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
Name | Typ | Beschreibung |
---|---|---|
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel, mit dem der Hash generiert wird. |
charset | Charset | Ein Charset , der den Eingabezeichensatz darstellt. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeHmacSignature(algorithm, value, key)
Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode 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
Name | Typ | Beschreibung |
---|---|---|
algorithm | MacAlgorithm | Ein MacAlgorithm -Algorithmus, mit dem der Eingabewert gehasht wird. |
value | Byte[] | Der Eingabewert, für den ein Hash generiert werden soll. |
key | Byte[] | Ein Schlüssel, mit dem der Hash generiert wird. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeHmacSignature(algorithm, value, key)
Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode 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
Name | Typ | Beschreibung |
---|---|---|
algorithm | MacAlgorithm | Ein MacAlgorithm -Algorithmus, mit dem der Eingabewert gehasht wird. |
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel, mit dem der Hash generiert wird. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeHmacSignature(algorithm, value, key, charset)
Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode 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
Name | Typ | Beschreibung |
---|---|---|
algorithm | MacAlgorithm | Ein MacAlgorithm -Algorithmus, mit dem der Eingabewert gehasht wird. |
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel, mit dem der Hash generiert wird. |
charset | Charset | Ein Charset , der den Eingabezeichensatz darstellt. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeRsaSha1Signature(value, key)
Signiert den angegebenen Wert mit 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
Name | Typ | Beschreibung |
---|---|---|
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeRsaSha1Signature(value, key, charset)
Signiert den angegebenen Wert mit 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
Name | Typ | Beschreibung |
---|---|---|
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird. |
charset | Charset | Ein Charset , der den Eingabezeichensatz darstellt. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeRsaSha256Signature(value, key)
Signiert den angegebenen Wert mit 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
Name | Typ | Beschreibung |
---|---|---|
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeRsaSha256Signature(value, key, charset)
Signiert den angegebenen Wert mit 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
Name | Typ | Beschreibung |
---|---|---|
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird. |
charset | Charset | Ein Charset , der den Eingabezeichensatz darstellt. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeRsaSignature(algorithm, value, key)
Signiert den angegebenen Wert mit dem 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
Name | Typ | Beschreibung |
---|---|---|
algorithm | RsaAlgorithm | Ein RsaAlgorithm -Algorithmus, mit dem der Eingabewert gehasht wird. |
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
computeRsaSignature(algorithm, value, key, charset)
Signiert den angegebenen Wert mit dem 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
Name | Typ | Beschreibung |
---|---|---|
algorithm | RsaAlgorithm | Ein RsaAlgorithm -Algorithmus, mit dem der Eingabewert gehasht wird. |
value | String | Der Eingabewert, für den ein Hash generiert werden soll. |
key | String | Ein Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird. |
charset | Charset | Ein Charset , der den Eingabezeichensatz darstellt. |
Return
Byte[]
: Ein Byte[], das die Ausgabesignatur darstellt.
formatDate(date, timeZone, format)
Formatiert Datum gemäß der in der Java SE SimpleDateFormat-Klasse beschriebenen Spezifikation. 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
Name | Typ | Beschreibung |
---|---|---|
date | Date | Ein Date , der als String formatiert werden soll. |
timeZone | String | Die Ausgabezeitzone des Ergebnisses. |
format | String | Ein Format gemäß der SimpleDateFormat -Spezifikation. |
Return
String
: Das Eingabedatum als formatierter String.
formatString(template, args)
Führt eine sprintf
-ähnliche Stringformatierung mit Formatstrings im „%“-Stil durch.
// " 123.456000" Utilities.formatString('%11.6f', 123.456); // " abc" Utilities.formatString('%6s', 'abc');
Parameter
Name | Typ | Beschreibung |
---|---|---|
template | String | Der Formatstring, der steuert, was zurückgegeben wird. |
args | Object... | Objekte, die zum Ausfüllen der "%"-Platzhalter in der Vorlage verwendet werden |
Return
String
: Der formatierte String.
getUuid()
Rufen Sie eine UUID als String ab (entspricht der Verwendung der Methode java.util.UUID.randomUUID()
). Es kann nicht garantiert werden, dass diese Kennung über die gesamte Zeit und den gesamten Raum eindeutig ist. Verwenden Sie diese Methode 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(); };
Return
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
Name | Typ | Beschreibung |
---|---|---|
blob | BlobSource | Ein Blob -Objekt, das mit gzip komprimiert werden soll. |
Return
gzip(blob, name)
gzip
komprimiert die bereitgestellten Blob
-Daten und gibt sie in einem neuen Blob
-Objekt zurück. Diese Version der Methode ermöglicht die Angabe eines Dateinamens.
var textBlob = Utilities.newBlob("Some text to compress using gzip compression"); // Create the compressed blob. var gzipBlob = Utilities.gzip(textBlob, "text.gz");
Parameter
Name | Typ | Beschreibung |
---|---|---|
blob | BlobSource | Ein Blob -Objekt, das mit gzip komprimiert werden soll. |
name | String | Der Name der gzip -Datei, die erstellt werden soll. |
Return
newBlob(data)
Erstellt ein neues Blob-Objekt aus einem Byte-Array. Blobs werden in vielen Apps Script APIs verwendet, die Binärdaten als Eingabe verarbeiten.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
data | Byte[] | Die Byte für das Blob. |
Return
Blob
: Das 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 verwenden.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
data | Byte[] | Die Byte für das Blob. |
contentType | String | Der Inhaltstyp des Blobs kann null sein. |
Return
Blob
: Das 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.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
data | Byte[] | Die Byte für das Blob. |
contentType | String | – Der Inhaltstyp des Blobs kann null sein. |
name | String | Der Name des Blobs kann null sein. |
Return
Blob
: Das 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.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
data | String | Der String für das Blob (UTF-8). |
Return
Blob
: Das neu erstellte Blob.
newBlob(data, contentType)
Erstellt ein neues Blob-Objekt aus einem String und Inhaltstyp. Blobs werden in vielen Apps Script APIs verwendet, die Binärdaten als Eingabe verwenden.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
data | String | Der String für das Blob (UTF-8). |
contentType | String | Der Inhaltstyp des Blobs kann null sein. |
Return
Blob
: Das 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.
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
data | String | Der String für das Blob (UTF-8). |
contentType | String | Der Inhaltstyp des Blobs kann null sein. |
name | String | Der Name des Blobs kann null sein. |
Return
Blob
: Das 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
Name | Typ | Beschreibung |
---|---|---|
csv | String | Ein String, der ein- oder mehrzeilige Daten im CSV-Format (kommagetrennte Werte) enthält. |
Return
String[][]
: Ein zweidimensionales Array, das die Werte im CSV-String enthält.
parseCsv(csv, delimiter)
Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings unter Verwendung eines benutzerdefinierten Trennzeichens 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
Name | Typ | Beschreibung |
---|---|---|
csv | String | Ein String, der ein- oder mehrzeilige Daten im CSV-Format (kommagetrennte Werte) enthält. |
delimiter | Char | Zwischen Werten. |
Return
String[][]
: Ein zweidimensionales Array, das die Werte im CSV-String enthält.
parseDate(date, timeZone, format)
Analysiert das angegebene Stringdatum gemäß der Spezifikation, die in der SimpleDateFormat
-Klasse der Java Standard Edition beschrieben ist. Weitere Informationen finden Sie in der Java-Klasse SimpleDateFormat
.
// 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
Name | Typ | Beschreibung |
---|---|---|
date | String | Ein Stringwert, der als Datum geparst werden soll. |
timeZone | String | Die Zeitzone der Ausgabe. |
format | String | Das Datumsformat gemäß der SimpleDateFormat -Spezifikation. |
Return
Date
: Der Eingabestring als Datum.
sleep(milliseconds)
Schlaft für eine bestimmte Anzahl von Millisekunden. Versetzt das Skript sofort für die angegebene Anzahl von Millisekunden in den Ruhemodus. Der maximal zulässige Wert ist 300.000 (oder 5 Minuten).
// 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());
Parameter
Name | Typ | Beschreibung |
---|---|---|
milliseconds | Integer | Die Anzahl der Millisekunden, die geschlafen werden soll. |
ungzip(blob)
Dekomprimiert ein Blob
-Objekt und gibt ein Blob
-Objekt 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
Name | Typ | Beschreibung |
---|---|---|
blob | BlobSource | Die Blob komprimierter Daten. |
Return
unzip(blob)
Nimmt einen Blob, der eine ZIP-Datei darstellt, und gibt deren 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
Name | Typ | Beschreibung |
---|---|---|
blob | BlobSource | Das ZIP-Datei-Blob. |
Return
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, bei dem es sich um eine ZIP-Datei handelt, 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
Name | Typ | Beschreibung |
---|---|---|
blobs | BlobSource[] | Ein Array von Blobs, die verpackt werden sollen. |
Return
Blob
: Ein neues Blob, das die Eingaben als Archiv enthält.
zip(blobs, name)
Erstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei handelt, die die Daten aus den übergebenen Blobs enthält. Mit 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
Name | Typ | Beschreibung |
---|---|---|
blobs | BlobSource[] | Ein Array von Blobs, die verpackt werden sollen. |
name | String | Der Name der zu erstellenden ZIP-Datei. |
Return
Blob
: Ein neues Blob, das die Eingaben als Archiv enthält.