Class Utilities

Narzędzia

Ta usługa udostępnia narzędzia do kodowania/dekodowania ciągów znaków, formatowania dat, manipulacji JSON i inne zadania.

Właściwości

WłaściwośćTypOpis
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

Metody

MetodaZwracany typKrótki opis
base64Decode(encoded)Byte[]Dekoduje ciąg zakodowany w standardzie base-64 do tablicy bajtów UTF-8.
base64Decode(encoded, charset)Byte[]Dekoduje ciąg zakodowany w standardzie base-64 do tablicy bajtów w określonym zestawie znaków.
base64DecodeWebSafe(encoded)Byte[]Dekoduje ciąg zakodowany w standardzie base-64 do postaci tablicy bajtów w formacie UTF-8.
base64DecodeWebSafe(encoded, charset)Byte[]Dekoduje ciąg zakodowany w standardzie base-64 do postaci tablicy bajtów w określonym zestawie znaków.
base64Encode(data)StringGeneruje ciąg zakodowany w standardzie base-64 z podanej tablicy bajtów.
base64Encode(data)StringGeneruje ciąg zakodowany w formacie base-64 z danego ciągu znaków.
base64Encode(data, charset)StringGeneruje ciąg zakodowany w formacie base-64 z danego ciągu znaków w określonym zestawie znaków.
base64EncodeWebSafe(data)StringGeneruje bezpieczny w internecie ciąg zakodowany w standardzie base-64 z podanej tablicy bajtów.
base64EncodeWebSafe(data)StringGeneruje z danego ciągu ciąg zakodowany do bezpiecznego w internecie w standardzie base-64.
base64EncodeWebSafe(data, charset)StringGeneruje bezpieczny w internecie ciąg zakodowany w standardzie base-64 z danego ciągu znaków w określonym zestawie znaków.
computeDigest(algorithm, value)Byte[]Oblicz skrót przy użyciu określonego algorytmu dla określonej wartości Byte[].
computeDigest(algorithm, value)Byte[]Oblicz skrót przy użyciu określonego algorytmu dla określonej wartości String.
computeDigest(algorithm, value, charset)Byte[]Oblicz skrót za pomocą podanego algorytmu dla określonej wartości String z podanym zestawem znaków.
computeHmacSha256Signature(value, key)Byte[]Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem.
computeHmacSha256Signature(value, key)Byte[]Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem.
computeHmacSha256Signature(value, key, charset)Byte[]Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem i zestawem znaków.
computeHmacSignature(algorithm, value, key)Byte[]Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości.
computeHmacSignature(algorithm, value, key)Byte[]Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości.
computeHmacSignature(algorithm, value, key, charset)Byte[]Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości.
computeRsaSha1Signature(value, key)Byte[]Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 danego klucza.
computeRsaSha1Signature(value, key, charset)Byte[]Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 z danym kluczem i zestawem znaków.
computeRsaSha256Signature(value, key)Byte[]Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 danego klucza.
computeRsaSha256Signature(value, key, charset)Byte[]Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 danego klucza.
computeRsaSignature(algorithm, value, key)Byte[]Podpisuje podaną wartość za pomocą określonego algorytmu RSA za pomocą danego klucza.
computeRsaSignature(algorithm, value, key, charset)Byte[]Podpisuje podaną wartość za pomocą określonego algorytmu RSA z danym kluczem i zestawem znaków.
formatDate(date, timeZone, format)StringFormatuje datę zgodnie ze specyfikacją opisaną w klasie SimpleDateFormat języka Java SE.
formatString(template, args)StringWykonuje formatowanie ciągów podobne do sprintf z użyciem ciągów formatu w stylu „%”.
getUuid()StringPobierz identyfikator UUID jako ciąg znaków (odpowiednik metody java.util.UUID.randomUUID()).
gzip(blob)Blobgzip kompresuje podane dane Blob i zwraca je w nowym obiekcie Blob.
gzip(blob, name)Blobgzip kompresuje podane dane Blob i zwraca je w nowym obiekcie Blob.
newBlob(data)BlobUtwórz nowy obiekt Blob na podstawie tablicy bajtów.
newBlob(data, contentType)BlobUtwórz nowy obiekt Blob na podstawie tablicy bajtów i typu treści.
newBlob(data, contentType, name)BlobUtwórz nowy obiekt Blob na podstawie tablicy bajtów oraz typu treści i nazwy.
newBlob(data)BlobUtwórz nowy obiekt Blob na podstawie ciągu znaków.
newBlob(data, contentType)BlobUtwórz nowy obiekt Blob na podstawie ciągu znaków i typu treści.
newBlob(data, contentType, name)BlobUtwórz nowy obiekt Blob na podstawie ciągu znaków, typu treści i nazwy.
parseCsv(csv)String[][]Zwraca tabelaryczną tablicę 2D ciągu znaków CSV.
parseCsv(csv, delimiter)String[][]Zwraca tabelę 2D reprezentującą ciąg znaków CSV z użyciem niestandardowego separatora.
parseDate(date, timeZone, format)DateAnalizuje podaną datę w ciągu znaków zgodnie ze specyfikacją opisaną w klasie SimpleDateFormat w standardowej wersji Java.
sleep(milliseconds)voidSen przez określoną liczbę milisekund.
ungzip(blob)BlobDekompresuje obiekt Blob i zwraca obiekt Blob zawierający nieskompresowane dane.
unzip(blob)Blob[]Pobiera obiekt blob reprezentujący plik ZIP i zwraca jego pliki komponentu.
zip(blobs)BlobTworzy nowy obiekt obiektu Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob.
zip(blobs, name)BlobTworzy nowy obiekt obiektu Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob.

Szczegółowa dokumentacja

base64Decode(encoded)

Dekoduje ciąg zakodowany w standardzie base-64 do tablicy bajtów UTF-8.

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

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

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

Parametry

NazwaTypOpis
encodedStringTablica bajtów danych do zdekodowania.

Powroty

Byte[] – nieprzetworzone dane reprezentowane przez argument zakodowany w formacie base-64 w postaci tablicy bajtów.


base64Decode(encoded, charset)

Dekoduje ciąg zakodowany w standardzie base-64 do tablicy bajtów w określonym zestawie znaków.

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

Parametry

NazwaTypOpis
encodedStringCiąg danych do zdekodowania.
charsetCharsetCharset określający zestaw znaków w danych wejściowych.

Powroty

Byte[] – nieprzetworzone dane reprezentowane przez argument zakodowany w formacie base-64 w postaci tablicy bajtów.


base64DecodeWebSafe(encoded)

Dekoduje ciąg zakodowany w standardzie base-64 do postaci tablicy bajtów w formacie UTF-8.

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

var decoded = Utilities.base64DecodeWebSafe(base64data);

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

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

Parametry

NazwaTypOpis
encodedStringTablica bajtów danych do zdekodowania w internecie.

Powroty

Byte[] – nieprzetworzone dane reprezentowane przez argument zakodowany w formacie base-64 w postaci tablicy bajtów.


base64DecodeWebSafe(encoded, charset)

Dekoduje ciąg zakodowany w standardzie base-64 do postaci tablicy bajtów w określonym zestawie znaków.

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

Parametry

NazwaTypOpis
encodedStringCiąg danych do zdekodowania w internecie.
charsetCharsetCharset określający zestaw znaków w danych wejściowych.

Powroty

Byte[] – nieprzetworzone dane reprezentowane przez argument zakodowany w formacie base-64 w postaci tablicy bajtów.


base64Encode(data)

Generuje ciąg zakodowany w standardzie base-64 z podanej tablicy bajtów. Base64 to popularne kodowanie akceptowane przez różne narzędzia, które nie akceptują danych binarnych. Kod Base64 jest często używany w protokołach internetowych, takich jak poczta e-mail, HTTP czy dokumenty XML.

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

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

Parametry

NazwaTypOpis
dataByte[]Bajt[] danych do zakodowania.

Powroty

String – reprezentacja danych przekazywanych w danych zakodowana w formacie base-64.


base64Encode(data)

Generuje ciąg zakodowany w formacie base-64 z danego ciągu znaków. Base64 to popularne kodowanie akceptowane przez różne narzędzia, które nie akceptują danych binarnych. Base64 jest powszechnie stosowany w protokołach internetowych, takich jak e-mail, HTTP, czy w dokumentach XML.

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

Parametry

NazwaTypOpis
dataStringCiąg do zakodowania.

Powroty

String – reprezentacja ciągu wejściowego zakodowana w formacie base64.


base64Encode(data, charset)

Generuje ciąg zakodowany w formacie base-64 z danego ciągu znaków w określonym zestawie znaków. Zestaw znaków to sposób kodowania znaków w taki sposób, aby można było je kodować. Zwykle odbywa się to w formacie binarnym, który może być niekompatybilny z niektórymi protokołami przesyłania danych. Aby dane były zgodne, są zwykle kodowane w standardzie base64, czyli kodowaniu powszechnie akceptowanym przez wiele narzędzi nie akceptujących danych binarnych. Kod Base64 jest często używany w protokołach internetowych, takich jak poczta e-mail, HTTP czy dokumenty XML.

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

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

Parametry

NazwaTypOpis
dataStringCiąg danych do zakodowania.
charsetCharsetCharset określający zestaw znaków w danych wejściowych.

Powroty

String – reprezentacja ciągu wejściowego o określonej wartości Charset zakodowana w formacie base64.


base64EncodeWebSafe(data)

Generuje bezpieczny w internecie ciąg zakodowany w standardzie base-64 z podanej tablicy bajtów. Base64 to popularne kodowanie akceptowane przez różne narzędzia, które nie akceptują danych binarnych. Standard Base64 jest powszechnie używany w protokołach internetowych takich jak poczta e-mail, HTTP czy dokumenty XML.

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

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

Parametry

NazwaTypOpis
dataByte[]Tablica bajtów danych do zakodowania.

Powroty

String – reprezentacja przekazywanych danych zakodowana w standardzie base-64 w internecie.


base64EncodeWebSafe(data)

Generuje z danego ciągu ciąg zakodowany do bezpiecznego w internecie w standardzie base-64. Base64 to popularne kodowanie akceptowane przez różne narzędzia, które nie akceptują danych binarnych. Standard Base64 w internecie jest powszechnie stosowany w protokołach internetowych takich jak poczta e-mail, HTTP czy dokumenty XML.

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

Parametry

NazwaTypOpis
dataStringCiąg do zakodowania.

Powroty

String – reprezentacja ciągu wejściowego zakodowana w standardzie base-64 w internecie.


base64EncodeWebSafe(data, charset)

Generuje bezpieczny w internecie ciąg zakodowany w standardzie base-64 z danego ciągu znaków w określonym zestawie znaków. Zestaw znaków to sposób kodowania znaków w taki sposób, aby mogły one być kodowane. Zwykle odbywa się to w formacie binarnym, który może być niezgodny z niektórymi protokołami przesyłania danych. Aby dane były zgodne, są zwykle kodowane w standardzie base64, czyli kodowaniu powszechnie akceptowanym przez wiele narzędzi, które nie akceptują danych binarnych. Standard Base64 jest powszechnie używany w protokołach internetowych takich jak poczta e-mail, HTTP czy dokumenty XML.

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

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

Parametry

NazwaTypOpis
dataStringCiąg danych do zakodowania.
charsetCharsetCharset określający zestaw znaków w danych wejściowych.

Powroty

String – zakodowana w standardzie base-64 reprezentacja ciągu wejściowego z danymi Charset.


computeDigest(algorithm, value)

Oblicz skrót przy użyciu określonego algorytmu dla określonej wartości Byte[].

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

Parametry

NazwaTypOpis
algorithmDigestAlgorithmDigestAlgorithm do użycia.
valueByte[]Wartość ciągu wejściowego, dla którego zostanie obliczony skrót.

Powroty

Byte[] – bajt[] reprezentujący skrót wyjściowy.


computeDigest(algorithm, value)

Oblicz skrót przy użyciu określonego algorytmu dla określonej wartości String.

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

Parametry

NazwaTypOpis
algorithmDigestAlgorithmDigestAlgorithm do użycia.
valueStringWartość ciągu wejściowego, dla którego zostanie obliczony skrót.

Powroty

Byte[] – bajt[] reprezentujący skrót wyjściowy.


computeDigest(algorithm, value, charset)

Oblicz skrót za pomocą podanego algorytmu dla określonej wartości String z podanym zestawem znaków.

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

Parametry

NazwaTypOpis
algorithmDigestAlgorithmDigestAlgorithm do użycia.
valueStringWartość ciągu wejściowego, dla którego zostanie obliczony skrót.
charsetCharsetElement Charset reprezentujący wpisany zestaw znaków.

Powroty

Byte[] – bajt[] reprezentujący skrót wyjściowy.


computeHmacSha256Signature(value, key)

Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem.

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

Parametry

NazwaTypOpis
valueByte[]Wartość wejściowa, dla której ma zostać wygenerowany hasz.
keyByte[]Klucz, za pomocą którego można wygenerować hasz.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeHmacSha256Signature(value, key)

Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem.

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

Parametry

NazwaTypOpis
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz, za pomocą którego można wygenerować hasz.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeHmacSha256Signature(value, key, charset)

Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z danym kluczem i zestawem znaków.

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

Parametry

NazwaTypOpis
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz, za pomocą którego można wygenerować hasz.
charsetCharsetElement Charset reprezentujący wpisany zestaw znaków.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeHmacSignature(algorithm, value, key)

Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości.

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

Parametry

NazwaTypOpis
algorithmMacAlgorithmAlgorytm MacAlgorithm, który służy do haszowania wartości wejściowej.
valueByte[]Wartość wejściowa, dla której ma zostać wygenerowany hasz.
keyByte[]Klucz, za pomocą którego można wygenerować hasz.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeHmacSignature(algorithm, value, key)

Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości.

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

Parametry

NazwaTypOpis
algorithmMacAlgorithmAlgorytm MacAlgorithm, który służy do haszowania wartości wejściowej.
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz, za pomocą którego można wygenerować hasz.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeHmacSignature(algorithm, value, key, charset)

Oblicza kod uwierzytelniania wiadomości za pomocą określonego algorytmu dla określonego klucza i wartości.

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

Parametry

NazwaTypOpis
algorithmMacAlgorithmAlgorytm MacAlgorithm, który służy do haszowania wartości wejściowej.
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz, za pomocą którego można wygenerować hasz.
charsetCharsetElement Charset reprezentujący wpisany zestaw znaków.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeRsaSha1Signature(value, key)

Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 danego klucza.

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

Parametry

NazwaTypOpis
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz w formacie PEM służący do generowania podpisu.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeRsaSha1Signature(value, key, charset)

Podpisuje podaną wartość za pomocą algorytmu RSA-SHA1 z danym kluczem i zestawem znaków.

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

Parametry

NazwaTypOpis
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz w formacie PEM służący do generowania podpisu.
charsetCharsetElement Charset reprezentujący wpisany zestaw znaków.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeRsaSha256Signature(value, key)

Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 danego klucza.

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

Parametry

NazwaTypOpis
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz w formacie PEM służący do generowania podpisu.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeRsaSha256Signature(value, key, charset)

Podpisuje podaną wartość za pomocą algorytmu RSA-SHA256 danego klucza.

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

Parametry

NazwaTypOpis
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz w formacie PEM służący do generowania podpisu.
charsetCharsetElement Charset reprezentujący wpisany zestaw znaków.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeRsaSignature(algorithm, value, key)

Podpisuje podaną wartość za pomocą określonego algorytmu RSA za pomocą danego klucza.

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

Parametry

NazwaTypOpis
algorithmRsaAlgorithmAlgorytm RsaAlgorithm, który służy do haszowania wartości wejściowej.
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz w formacie PEM służący do generowania podpisu.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


computeRsaSignature(algorithm, value, key, charset)

Podpisuje podaną wartość za pomocą określonego algorytmu RSA z danym kluczem i zestawem znaków.

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

Parametry

NazwaTypOpis
algorithmRsaAlgorithmAlgorytm RsaAlgorithm, który służy do haszowania wartości wejściowej.
valueStringWartość wejściowa, dla której ma zostać wygenerowany hasz.
keyStringKlucz w formacie PEM służący do generowania podpisu.
charsetCharsetElement Charset reprezentujący wpisany zestaw znaków.

Powroty

Byte[] – bajt[] reprezentujący podpis wyjściowy.


formatDate(date, timeZone, format)

Formatuje datę zgodnie ze specyfikacją opisaną w klasie SimpleDateFormat języka Java SE. Zapoznaj się ze specyfikacją na stronie 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);

Parametry

NazwaTypOpis
dateDateDate do sformatowania jako ciągu znaków.
timeZoneStringStrefa czasowa wyjściowa wyniku.
formatStringFormat zgodny ze specyfikacją SimpleDateFormat.

Powroty

String – data wejściowa w postaci sformatowanego ciągu znaków.


formatString(template, args)

Wykonuje formatowanie ciągów podobne do sprintf z użyciem ciągów formatu w stylu „%”.

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

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

Parametry

NazwaTypOpis
templateStringCiąg formatu określający, co jest zwracane.
argsObject...Obiekty używane w szablonie do wypełnienia obiektów zastępczych „%”.

Powroty

String – sformatowany ciąg znaków.


getUuid()

Pobierz identyfikator UUID jako ciąg znaków (odpowiednik metody java.util.UUID.randomUUID()). Nie ma gwarancji, że identyfikator będzie niepowtarzalny w całym czasie i w przestrzeni. Dlatego nie używaj ich w sytuacjach, w których jest wymagana gwarantowana niepowtarzalność.

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

Powroty

String – ciąg reprezentujący identyfikator UUID.


gzip(blob)

gzip kompresuje podane dane Blob i zwraca je w nowym obiekcie Blob.

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

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

Parametry

NazwaTypOpis
blobBlobSourceObiekt Blob do skompresowania za pomocą gzip.

Powroty

Blob – nowy Blob zawierający skompresowane dane.


gzip(blob, name)

gzip kompresuje podane dane Blob i zwraca je w nowym obiekcie Blob. Ta wersja metody umożliwia określenie nazwy pliku.

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

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

Parametry

NazwaTypOpis
blobBlobSourceObiekt Blob do skompresowania za pomocą gzip.
nameStringNazwa pliku gzip do utworzenia.

Powroty

Blob – nowy Blob zawierający skompresowane dane.


newBlob(data)

Utwórz nowy obiekt Blob na podstawie tablicy bajtów. Bloby są używane w wielu interfejsach API Apps Script, które pobierają dane binarne jako dane wejściowe.

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

Parametry

NazwaTypOpis
dataByte[]Bajty obiektu blob.

Powroty

Blob – nowo utworzony obiekt blob.


newBlob(data, contentType)

Utwórz nowy obiekt Blob na podstawie tablicy bajtów i typu treści. Plamy są używane w wielu interfejsach Apps Script API, które pobierają dane binarne jako dane wejściowe.

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

Parametry

NazwaTypOpis
dataByte[]Bajty obiektu blob.
contentTypeStringTyp treści obiektu blob – może być null.

Powroty

Blob – nowo utworzony obiekt blob.


newBlob(data, contentType, name)

Utwórz nowy obiekt Blob na podstawie tablicy bajtów oraz typu treści i nazwy. Bloby są używane w wielu interfejsach API Apps Script, które pobierają dane binarne jako dane wejściowe.

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

Parametry

NazwaTypOpis
dataByte[]Bajty obiektu blob.
contentTypeString– typ treści obiektu blob – może być ustawiony na null.
nameStringNazwa obiektu blob – może być null.

Powroty

Blob – nowo utworzony obiekt blob.


newBlob(data)

Utwórz nowy obiekt Blob na podstawie ciągu znaków. Bloby są używane w wielu interfejsach API Apps Script, które pobierają dane binarne jako dane wejściowe.

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

Parametry

NazwaTypOpis
dataStringCiąg znaków bloba zakładany w formacie UTF-8.

Powroty

Blob – nowo utworzony obiekt blob.


newBlob(data, contentType)

Utwórz nowy obiekt Blob na podstawie ciągu znaków i typu treści. Plamy są używane w wielu interfejsach Apps Script API, które pobierają dane binarne jako dane wejściowe.

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

Parametry

NazwaTypOpis
dataStringCiąg znaków bloba zakładany w formacie UTF-8.
contentTypeStringTyp treści obiektu blob – może być null.

Powroty

Blob – nowo utworzony obiekt blob.


newBlob(data, contentType, name)

Utwórz nowy obiekt Blob na podstawie ciągu znaków, typu treści i nazwy. Bloby są używane w wielu interfejsach API Apps Script, które pobierają dane binarne jako dane wejściowe.

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

Parametry

NazwaTypOpis
dataStringCiąg znaków bloba zakładany w formacie UTF-8.
contentTypeStringTyp treści obiektu blob – może być null.
nameStringNazwa obiektu blob – może być null.

Powroty

Blob – nowo utworzony obiekt blob.


parseCsv(csv)

Zwraca tabelaryczną tablicę 2D ciągu znaków CSV.

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

Parametry

NazwaTypOpis
csvStringCiąg znaków zawierający dane w jednym lub wielu wierszach w formacie CSV.

Powroty

String[][] – dwuwymiarowa tablica zawierająca wartości z ciągu CSV.


parseCsv(csv, delimiter)

Zwraca tabelę 2D reprezentującą ciąg znaków CSV z użyciem niestandardowego separatora.

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

Parametry

NazwaTypOpis
csvStringCiąg znaków zawierający dane w jednym lub wielu wierszach w formacie CSV.
delimiterCharMiędzy wartościami.

Powroty

String[][] – dwuwymiarowa tablica zawierająca wartości z ciągu CSV.


parseDate(date, timeZone, format)

Analizuje podaną datę w ciągu znaków zgodnie ze specyfikacją opisaną w klasie SimpleDateFormat w standardowej wersji Java. Więcej informacji znajdziesz w klasie SimpleDateFormat Java.

// This set of parameters parses the given string as a date in Greenwich Mean Time, formatted
// as year-month-dateThour-minute-second.
var date = Utilities.parseDate("1970-01-01 00:00:00", "GMT", "yyyy-MM-dd' 'HH:mm:ss");
Logger.log(date);

Parametry

NazwaTypOpis
dateStringWartość ciągu znaków do przeanalizowania jako daty.
timeZoneStringStrefa czasowa danych wyjściowych.
formatStringFormat daty zgodny ze specyfikacją SimpleDateFormat.

Powroty

Date – ciąg wejściowy jako data.


sleep(milliseconds)

Sen przez określoną liczbę milisekund. Natychmiast przełącza skrypt w tryb uśpienia przez określoną liczbę milisekund. Maksymalna dozwolona wartość to 300 000 (czyli 5 minut).

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

Parametry

NazwaTypOpis
millisecondsIntegerLiczba milisekund do snu.

ungzip(blob)

Dekompresuje obiekt Blob i zwraca obiekt Blob zawierający nieskompresowane dane.

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

Parametry

NazwaTypOpis
blobBlobSourceBlob skompresowanych danych.

Powroty

BlobBlob reprezentujący zdekompresowane dane.


unzip(blob)

Pobiera obiekt blob reprezentujący plik ZIP i zwraca jego pliki komponentu.

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

Parametry

NazwaTypOpis
blobBlobSourceObiekt blob pliku ZIP.

Powroty

Blob[] – obiekt blob[] reprezentujący obiekt blob komponentu, z których każda ma pełną nazwę w komponencie zip.


zip(blobs)

Tworzy nowy obiekt obiektu Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob.

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

Parametry

NazwaTypOpis
blobsBlobSource[]Tablica blobów do skompresowania.

Powroty

Blob – nowy obiekt blob zawierający dane wejściowe jako archiwum.


zip(blobs, name)

Tworzy nowy obiekt obiektu Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob. Ta wersja metody umożliwia określenie nazwy pliku.

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

Parametry

NazwaTypOpis
blobsBlobSource[]Tablica blobów do skompresowania.
nameStringNazwa pliku ZIP do utworzenia.

Powroty

Blob – nowy obiekt blob zawierający dane wejściowe jako archiwum.

Wycofane metody