Diese Seite wurde von der Cloud Translation API übersetzt.

Class Utilities

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

Attribute

Attribut	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 Byte-Array in einem bestimmten Zeichensatz.
`base64DecodeWebSafe(encoded)`	`Byte[]`	Decodiert einen websicheren Base64-codierten String in ein UTF-8-Byte-Array.
`base64DecodeWebSafe(encoded, charset)`	`Byte[]`	Decodiert einen Base64-codierten, websicheren String in ein Byte-Array in einem bestimmten Zeichensatz.
`base64Encode(data)`	`String`	Generiert einen Base64-codierten String aus dem angegebenen Byte-Array.
`base64Encode(data)`	`String`	Generiert einen base64-codierten String aus dem angegebenen String.
`base64Encode(data, charset)`	`String`	Generiert 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 aus dem angegebenen String einen websicheren Base64-codierten String.
`base64EncodeWebSafe(data, charset)`	`String`	Generiert einen websicheren Base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz.
`computeDigest(algorithm, value)`	`Byte[]`	Berechnet einen Hashwert mit dem angegebenen Algorithmus für den angegebenen `Byte[]`-Wert.
`computeDigest(algorithm, value)`	`Byte[]`	Berechnet einen Hashwert mit dem angegebenen Algorithmus für den angegebenen `String`-Wert.
`computeDigest(algorithm, value, charset)`	`Byte[]`	Berechnen Sie einen Hashwert mit dem angegebenen Algorithmus für den angegebenen `String`-Wert mit dem angegebenen Zeichensatz.
`computeHmacSha256Signature(value, key)`	`Byte[]`	Signiert den angegebenen Wert mit HMAC-SHA256 und dem angegebenen Schlüssel.
`computeHmacSha256Signature(value, key)`	`Byte[]`	Signiert den angegebenen Wert mit HMAC-SHA256 und dem angegebenen Schlüssel.
`computeHmacSha256Signature(value, key, charset)`	`Byte[]`	Signiert den angegebenen Wert mit 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 angegebenen Wert mit RSA-SHA1 und 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 und dem angegebenen Schlüssel.
`computeRsaSha256Signature(value, key, charset)`	`Byte[]`	Signiert den angegebenen Wert mit RSA-SHA256 und dem angegebenen Schlüssel.
`computeRsaSignature(algorithm, value, key)`	`Byte[]`	Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus und dem angegebenen Schlüssel.
`computeRsaSignature(algorithm, value, key, charset)`	`Byte[]`	Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus, dem angegebenen Schlüssel und dem angegebenen Zeichensatz.
`formatDate(date, timeZone, format)`	`String`	Formatiert das Datum gemäß der in der SimpleDateFormat-Klasse von Java SE beschriebenen Spezifikation.
`formatString(template, args)`	`String`	Führt eine `sprintf`-ähnliche Stringformatierung mit Formatstrings im Prozentformat aus.
`getUuid()`	`String`	Ruft eine UUID als String ab (entspricht der Verwendung der Methode `java.util.UUID.randomUUID()`).
`gzip(blob)`	`Blob`	`gzip` – Komprimiert die angegebenen `Blob`-Daten und gibt sie in einem neuen `Blob`-Objekt zurück.
`gzip(blob, name)`	`Blob`	`gzip` – Komprimiert die angegebenen `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`	Erstellen Sie ein neues Blob-Objekt aus einem Byte-Array und einem Inhaltstyp.
`newBlob(data, contentType, name)`	`Blob`	Erstellen Sie ein neues Blob-Objekt aus einem Byte-Array, einem Inhaltstyp und einem Namen.
`newBlob(data)`	`Blob`	Erstellen Sie ein neues Blob-Objekt aus einem String.
`newBlob(data, contentType)`	`Blob`	Erstellen Sie ein neues Blob-Objekt aus einem String und einem Inhaltstyp.
`newBlob(data, contentType, name)`	`Blob`	Erstellen Sie ein neues Blob-Objekt aus einem String, einem Inhaltstyp und einem Namen.
`parseCsv(csv)`	`String[][]`	Gibt eine tabellarische 2D-Array-Darstellung eines CSV-Strings zurück.
`parseCsv(csv, delimiter)`	`String[][]`	Gibt eine tabellarische 2D-Array-Darstellung eines CSV-Strings mit einem benutzerdefinierten Trennzeichen zurück.
`parseDate(date, timeZone, format)`	`Date`	Das angegebene Stringdatum wird gemäß der Spezifikation geparst, die in der Java Standard Edition-Klasse `SimpleDateFormat` beschrieben ist.
`sleep(milliseconds)`	`void`	Wartet die angegebene Anzahl von Millisekunden.
`ungzip(blob)`	`Blob`	Entpackt ein `Blob`-Objekt und gibt ein `Blob` mit den entpackten Daten zurück.
`unzip(blob)`	`Blob[]`	Nimmt einen Blob an, der eine ZIP-Datei darstellt, und gibt die Komponentendateien zurück.
`zip(blobs)`	`Blob`	Erstellt ein neues Blob-Objekt, das eine ZIP-Datei mit den Daten aus den übergebenen Blobs ist.
`zip(blobs, name)`	`Blob`	Erstellt ein neues Blob-Objekt, das eine ZIP-Datei mit den Daten aus den übergebenen Blobs ist.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`jsonParse(jsonString)`	`Object`	Gibt ein Objekt zurück, das dem übergebenen JSON-String entspricht.
`jsonStringify(obj)`	`String`	Gibt einen JSON-String des übergebenen Objekts zurück.

Detaillierte Dokumentation

`base64Decode(encoded)`

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

// This is the base64 encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
const decoded = Utilities.base64Decode(base64data);
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parameter

Name	Typ	Beschreibung
`encoded`	`String`	Ein Array von Datenbytes, die decodiert werden sollen.

Rückflug

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

`base64Decode(encoded, charset)`

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

// This is the base64 encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

const decoded = Utilities.base64Decode(base64data, Utilities.Charset.UTF_8);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parameter

Name	Typ	Beschreibung
`encoded`	`String`	Der zu decodierende Datenstring.
`charset`	`Charset`	Ein `Charset`, das den Zeichensatz der Eingabe angibt.

Rückflug

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

`base64DecodeWebSafe(encoded)`

Decodiert einen websicheren Base64-codierten String in ein UTF-8-Byte-Array.

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const decoded = Utilities.base64DecodeWebSafe(base64data);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parameter

Name	Typ	Beschreibung
`encoded`	`String`	Ein Array von Bytes mit websicheren Daten, die decodiert werden sollen.

Rückflug

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

`base64DecodeWebSafe(encoded, charset)`

Decodiert einen Base64-codierten, websicheren String in ein Byte-Array in einem bestimmten Zeichensatz.

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const decoded = Utilities.base64DecodeWebSafe(
    base64data,
    Utilities.Charset.UTF_8,
);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

Parameter

Name	Typ	Beschreibung
`encoded`	`String`	Der String mit den websicheren Daten, der decodiert werden soll.
`charset`	`Charset`	Ein `Charset`, das den Zeichensatz der Eingabe angibt.

Rückflug

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

`base64Encode(data)`

Generiert einen Base64-codierten String aus dem angegebenen Byte-Array. Base64 ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten akzeptieren. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64Encode(blob.getBytes());
Logger.log(encoded);

Parameter

Name	Typ	Beschreibung
`data`	`Byte[]`	Ein Byte[] mit Daten, die codiert werden sollen.

Rückflug

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

`base64Encode(data)`

Generiert einen 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 akzeptieren. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.

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

Parameter

Name	Typ	Beschreibung
`data`	`String`	Der zu codierende String.

Rückflug

String: Die Base64-codierte Darstellung des Eingabestrings.

`base64Encode(data, charset)`

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

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
const encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

Parameter

Name	Typ	Beschreibung
`data`	`String`	Der zu codierende Datenstring.
`charset`	`Charset`	Ein `Charset`, das den Zeichensatz der Eingabe angibt.

Rückflug

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

`base64EncodeWebSafe(data)`

Generiert einen websicheren Base64-codierten String aus dem angegebenen Byte-Array. Base64 ist eine gängige Codierung, die von einer Vielzahl von Tools unterstützt wird, die keine Binärdaten akzeptieren. Base64 Web-Safe wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64EncodeWebSafe(blob.getBytes());
Logger.log(encoded);

Parameter

Name	Typ	Beschreibung
`data`	`Byte[]`	Ein Array von Bytes mit Daten, die codiert werden sollen.

Rückflug

String: Die websichere Base64-Codierung der übergebenen Daten.

`base64EncodeWebSafe(data)`

Generiert aus dem angegebenen String einen websicheren Base64-codierten String. Base64 ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten akzeptieren. Base64 Web-Safe wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.

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

Parameter

Name	Typ	Beschreibung
`data`	`String`	Der zu codierende String.

Rückflug

String: Die websichere Base64-Codierung des Eingabestrings.

`base64EncodeWebSafe(data, charset)`

Generiert einen websicheren Base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz. Ein Zeichensatz ist eine Möglichkeit, Zeichen so zu codieren, dass sie codiert werden können. Diese werden in der Regel in einem Binärformat ausgeführt, das in der Regel nicht mit bestimmten Datenübertragungsprotokollen kompatibel ist. Damit die Daten kompatibel sind, werden sie in der Regel in Base64 codiert. Das ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine binären Daten akzeptieren. Base64 Web-Safe wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log
const encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

Parameter

Name	Typ	Beschreibung
`data`	`String`	Der zu codierende Datenstring.
`charset`	`Charset`	Ein `Charset`, das den Zeichensatz der Eingabe angibt.

Rückflug

String: Die websichere Base64-Codierung des Eingabestrings mit der angegebenen Charset.

`computeDigest(algorithm, value)`

Berechnet einen Hashwert mit dem angegebenen Algorithmus für den angegebenen Byte[]-Wert.

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

Parameter

Name	Typ	Beschreibung
`algorithm`	`DigestAlgorithm`	Ein `DigestAlgorithm`, das verwendet werden soll.
`value`	`Byte[]`	Ein Eingabestringwert, für den ein Hashwert berechnet werden soll.

Rückflug

Byte[]: Ein Byte[] für den Ausgabe-Digest.

`computeDigest(algorithm, value)`

Berechnet einen Hashwert mit dem angegebenen Algorithmus für den angegebenen String-Wert.

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

Parameter

Name	Typ	Beschreibung
`algorithm`	`DigestAlgorithm`	Ein `DigestAlgorithm`, das verwendet werden soll.
`value`	`String`	Ein Eingabestringwert, für den ein Hashwert berechnet werden soll.

Rückflug

Byte[]: Ein Byte[] für den Ausgabe-Digest.

`computeDigest(algorithm, value, charset)`

Berechnen Sie einen Hashwert mit dem angegebenen Algorithmus für den angegebenen String-Wert mit dem angegebenen Zeichensatz.

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

Parameter

Name	Typ	Beschreibung
`algorithm`	`DigestAlgorithm`	Ein `DigestAlgorithm`, das verwendet werden soll.
`value`	`String`	Ein Eingabestringwert, für den ein Hashwert berechnet werden soll.
`charset`	`Charset`	Eine `Charset`, die den Eingabezeichensatz darstellt.

Rückflug

Byte[]: Ein Byte[] für den Ausgabe-Digest.

`computeHmacSha256Signature(value, key)`

Signiert den angegebenen Wert mit HMAC-SHA256 und dem angegebenen Schlüssel.

// This writes an array of bytes to the log.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSha256Signature(input, key);
Logger.log(signature);

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 werden soll.

Rückflug

Byte[]: Ein Byte-Array, das die Ausgabesignatur darstellt.

`computeHmacSha256Signature(value, key)`

Signiert den angegebenen Wert mit HMAC-SHA256 und dem angegebenen Schlüssel.

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSha256Signature(
    'this is my input',
    'my key - use a stronger one',
);
Logger.log(signature);

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 werden soll.

Rückflug

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

`computeHmacSha256Signature(value, key, charset)`

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

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSha256Signature(
    'this is my input',
    'my key - use a stronger one',
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

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 werden soll.
`charset`	`Charset`	Eine `Charset`, die den Eingabezeichensatz darstellt.

Rückflug

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.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    input,
    key,
);
Logger.log(signature);

Parameter

Name	Typ	Beschreibung
`algorithm`	`MacAlgorithm`	Ein `MacAlgorithm`-Algorithmus, der zum Hashen des Eingabewerts verwendet wird.
`value`	`Byte[]`	Der Eingabewert, für den ein Hash generiert werden soll.
`key`	`Byte[]`	Ein Schlüssel, mit dem der Hash generiert werden soll.

Rückflug

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.
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    'input to hash',
    'key',
);
Logger.log(signature);

Parameter

Name	Typ	Beschreibung
`algorithm`	`MacAlgorithm`	Ein `MacAlgorithm`-Algorithmus, der zum Hashen des Eingabewerts verwendet wird.
`value`	`String`	Der Eingabewert, für den ein Hash generiert werden soll.
`key`	`String`	Ein Schlüssel, mit dem der Hash generiert werden soll.

Rückflug

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.
const 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, der zum Hashen des Eingabewerts verwendet wird.
`value`	`String`	Der Eingabewert, für den ein Hash generiert werden soll.
`key`	`String`	Ein Schlüssel, mit dem der Hash generiert werden soll.
`charset`	`Charset`	Eine `Charset`, die den Eingabezeichensatz darstellt.

Rückflug

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

`computeRsaSha1Signature(value, key)`

Signiert den angegebenen Wert mit RSA-SHA1 und dem angegebenen Schlüssel.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Parameter

Name	Typ	Beschreibung
`value`	`String`	Der Eingabewert, für den ein Hash generiert werden soll.
`key`	`String`	Ein PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.

Rückflug

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

`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.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    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 PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.
`charset`	`Charset`	Eine `Charset`, die den Eingabezeichensatz darstellt.

Rückflug

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

`computeRsaSha256Signature(value, key)`

Signiert den angegebenen Wert mit RSA-SHA256 und dem angegebenen Schlüssel.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Parameter

Name	Typ	Beschreibung
`value`	`String`	Der Eingabewert, für den ein Hash generiert werden soll.
`key`	`String`	Ein PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.

Rückflug

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

`computeRsaSha256Signature(value, key, charset)`

Signiert den angegebenen Wert mit RSA-SHA256 und dem angegebenen Schlüssel.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Parameter

Name	Typ	Beschreibung
`value`	`String`	Der Eingabewert, für den ein Hash generiert werden soll.
`key`	`String`	Ein PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.
`charset`	`Charset`	Eine `Charset`, die den Eingabezeichensatz darstellt.

Rückflug

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

`computeRsaSignature(algorithm, value, key)`

Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus und dem angegebenen Schlüssel.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

Parameter

Name	Typ	Beschreibung
`algorithm`	`RsaAlgorithm`	Ein `RsaAlgorithm`-Algorithmus, der zum Hashen des Eingabewerts verwendet wird.
`value`	`String`	Der Eingabewert, für den ein Hash generiert werden soll.
`key`	`String`	Ein PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.

Rückflug

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

`computeRsaSignature(algorithm, value, key, charset)`

Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus, dem angegebenen Schlüssel und dem angegebenen Zeichensatz.

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

Parameter

Name	Typ	Beschreibung
`algorithm`	`RsaAlgorithm`	Ein `RsaAlgorithm`-Algorithmus, der zum Hashen des Eingabewerts verwendet wird.
`value`	`String`	Der Eingabewert, für den ein Hash generiert werden soll.
`key`	`String`	Ein PEM-formatierter Schlüssel, der zum Generieren der Signatur verwendet wird.
`charset`	`Charset`	Eine `Charset`, die den Eingabezeichensatz darstellt.

Rückflug

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

`formatDate(date, timeZone, format)`

Formatiert das Datum gemäß der in der SimpleDateFormat-Klasse von Java SE beschriebenen Spezifikation. Weitere Informationen finden Sie in der Spezifikation 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.
const 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`, das als String formatiert werden soll.
`timeZone`	`String`	Die Ausgabezeitzone des Ergebnisses.
`format`	`String`	Ein Format gemäß der `SimpleDateFormat`-Spezifikation.

Rückflug

String: Das Eingabedatum als formatierter String.

`formatString(template, args)`

Führt eine sprintf-ähnliche Stringformatierung mit Formatstrings im Prozentformat aus.

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

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

Parameter

Name	Typ	Beschreibung
`template`	`String`	Der Formatstring, der festlegt, was zurückgegeben wird.
`args`	`Object...`	Objekte, mit denen die Platzhalter „%“ in der Vorlage ausgefüllt werden.

Rückflug

String: Der formatierte String.

`getUuid()`

Ruft eine UUID als String ab (entspricht der Verwendung der Methode java.util.UUID.randomUUID()). Diese Kennung ist nicht garantiert zeitlich und räumlich eindeutig. Verwenden Sie sie daher nicht in Situationen, in denen eine eindeutige Kennzeichnung erforderlich ist.

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

Rückflug

String: Stringdarstellung der UUID.

`gzip(blob)`

gzip – Komprimiert die angegebenen Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück.

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

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

Parameter

Name	Typ	Beschreibung
`blob`	`BlobSource`	Ein `Blob`-Objekt, das mit `gzip` komprimiert werden soll.

Rückflug

Blob – Eine neue Blob mit den komprimierten Daten.

`gzip(blob, name)`

gzip – Komprimiert die angegebenen Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück. Bei dieser Version der Methode kann ein Dateiname angegeben werden.

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

// Create the compressed blob.
const 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 zu erstellenden `gzip`-Datei.

Rückflug

Blob – Eine neue Blob mit den komprimierten Daten.

`newBlob(data)`

Erstellt ein neues Blob-Objekt aus einem Byte-Array. Blobs werden in vielen Apps Script APIs verwendet, die binäre Daten als Eingabe annehmen.

// 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 Bytes für den Blob.

Rückflug

Blob – der neu erstellte Blob.

`newBlob(data, contentType)`

Erstellen Sie ein neues Blob-Objekt aus einem Byte-Array und einem Inhaltstyp. Blobs werden in vielen Apps Script-APIs verwendet, die binäre Daten als Eingabe annehmen.

// 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 Bytes für den Blob.
`contentType`	`String`	Der Inhaltstyp des Blobs. Kann `null` sein.

Rückflug

Blob – der neu erstellte Blob.

`newBlob(data, contentType, name)`

Erstellen Sie ein neues Blob-Objekt aus einem Byte-Array, einem Inhaltstyp und einem Namen. Blobs werden in vielen Apps Script APIs verwendet, die binäre Daten als Eingabe annehmen.

// 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 Bytes für den Blob.
`contentType`	`String`	– Der Inhaltstyp des Blobs – kann `null` sein.
`name`	`String`	Der Name des Blobs. Kann `null` sein.

Rückflug

Blob – der neu erstellte Blob.

`newBlob(data)`

Erstellen Sie ein neues Blob-Objekt aus einem String. Blobs werden in vielen Apps Script APIs verwendet, die binäre Daten als Eingabe annehmen.

// 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 den Blob, UTF-8 vorausgesetzt.

Rückflug

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äre Daten als Eingabe annehmen.

// 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 den Blob, UTF-8 vorausgesetzt.
`contentType`	`String`	Der Inhaltstyp des Blobs. Kann `null` sein.

Rückflug

Blob – der neu erstellte Blob.

`newBlob(data, contentType, name)`

Erstellen Sie ein neues Blob-Objekt aus einem String, einem Inhaltstyp und einem Namen. Blobs werden in vielen Apps Script APIs verwendet, die binäre Daten als Eingabe annehmen.

// 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 den Blob, UTF-8 vorausgesetzt.
`contentType`	`String`	Der Inhaltstyp des Blobs. Kann `null` sein.
`name`	`String`	Der Name des Blobs. Kann `null` sein.

Rückflug

Blob – der neu erstellte Blob.

`parseCsv(csv)`

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

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a,b,c\nd,e,f';
const data = Utilities.parseCsv(csvString);

Parameter

Name	Typ	Beschreibung
`csv`	`String`	Ein String mit einzelnen oder mehrzeiligen Daten im CSV-Format (Comma Separated Value).

Rückflug

String[][]: Ein zweidimensionales Array mit den Werten im CSV-String.

`parseCsv(csv, delimiter)`

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

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a\tb\tc\nd\te\tf';
const data = Utilities.parseCsv(csvString, '\t');

Parameter

Name	Typ	Beschreibung
`csv`	`String`	Ein String mit einzelnen oder mehrzeiligen Daten im CSV-Format (Comma Separated Value).
`delimiter`	`Char`	Zwischenwerten

Rückflug

String[][]: Ein zweidimensionales Array mit den Werten im CSV-String.

`parseDate(date, timeZone, format)`

Das angegebene Stringdatum wird gemäß der Spezifikation geparst, die in der Java Standard Edition-Klasse SimpleDateFormat beschrieben ist. Weitere Informationen finden Sie im Artikel zur 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.
const 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 Ausgabezeitzone.
`format`	`String`	Das Datumsformat gemäß der `SimpleDateFormat`-Spezifikation.

Rückflug

Date: Der Eingabestring als Datum.

`sleep(milliseconds)`

Wartet die angegebene Anzahl von Millisekunden. Das Script wird sofort für die angegebene Anzahl von Millisekunden in den Ruhemodus versetzt. Der maximal zulässige Wert beträgt 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 gewartet werden soll.

`ungzip(blob)`

Entpackt ein Blob-Objekt und gibt ein Blob mit den entpackten Daten zurück.

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

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

// Uncompress the data.
const uncompressedBlob = Utilities.ungzip(gzipBlob);

Parameter

Name	Typ	Beschreibung
`blob`	`BlobSource`	Die `Blob` der komprimierten Daten.

Rückflug

Blob: Ein Blob, das die dekomprimierten Daten darstellt.

`unzip(blob)`

Nimmt einen Blob an, der eine ZIP-Datei darstellt, und gibt die Komponentendateien zurück.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

// This now unzips the blobs
const files = Utilities.unzip(zip);

Parameter

Name	Typ	Beschreibung
`blob`	`BlobSource`	Der Blob der ZIP-Datei.

Rückflug

Blob[]: Ein Blob[] für die Komponenten-Blobs, die jeweils mit dem vollständigen Pfad im ZIP-Archiv benannt sind.

`zip(blobs)`

Erstellt ein neues Blob-Objekt, das eine ZIP-Datei mit den Daten aus den übergebenen Blobs ist.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob]);

Parameter

Name	Typ	Beschreibung
`blobs`	`BlobSource[]`	Ein Array von Blobs, die komprimiert werden sollen.

Rückflug

Blob – Ein neuer Blob, der die Eingaben als Archiv enthält.

`zip(blobs, name)`

Erstellt ein neues Blob-Objekt, das eine ZIP-Datei mit den Daten aus den übergebenen Blobs ist. Bei dieser Version der Methode kann ein Dateiname angegeben werden.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

Parameter

Name	Typ	Beschreibung
`blobs`	`BlobSource[]`	Ein Array von Blobs, die komprimiert werden sollen.
`name`	`String`	Der Name der zu erstellenden ZIP-Datei.

Rückflug

Blob – Ein neuer Blob, der die Eingaben als Archiv enthält.

Eingestellte Methoden

`jsonParse(jsonString)`

Veraltet. Seit November 2013 durch JSON.parse() ersetzt

Gibt ein Objekt zurück, das dem übergebenen JSON-String entspricht.

// Returns the object { name: "John Smith", company: "Virginia Company"}
const obj = Utilities.jsonParse(
    '{"name":"John Smith","company":"Virginia Company"}',
);

Parameter

Name	Typ	Beschreibung
`jsonString`	`String`	Eine Stringdarstellung eines JavaScript-Objekts, das deserialisiert werden soll.

Rückflug

Object: Eine JavaScript-Objektdarstellung der Eingabe.

`jsonStringify(obj)`

Veraltet. Seit November 2013 durch JSON.stringify() ersetzt

Gibt einen JSON-String des übergebenen Objekts zurück.

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

Parameter

Name	Typ	Beschreibung
`obj`	`Object`	das JavaScript-Objekt, das in JSON serialisiert werden soll

Rückflug

String – ein JSON-serialisiertes JavaScript-Objekt