Class Utilities

Narzędzia

Ta usługa udostępnia narzędzia do kodowania i dekodowania ciągów znaków, formatowania daty, manipulowania kodem JSON i innych zadań.

Właściwości

Właściwość	Typ	Opis
Charset	Charset
DigestAlgorithm	DigestAlgorithm
MacAlgorithm	MacAlgorithm
RsaAlgorithm	RsaAlgorithm

Metody

Metoda	Zwracany typ	Kró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 formacie base64 w formacie internetowym do postaci tablicy bajtów UTF-8.
base64DecodeWebSafe(encoded, charset)	Byte[]	Dekoduje ciąg zakodowany w standardzie base-64 w formacie internetowym do postaci tablicy bajtów w określonym zestawie znaków.
base64Encode(data)	String	Generuje ciąg zakodowany w standardzie base-64 z danej tablicy bajtów.
base64Encode(data)	String	Generuje ciąg zakodowany w standardzie base-64 z podanego ciągu.
base64Encode(data, charset)	String	Generuje ciąg zakodowany w standardzie base-64 z danego ciągu o określonym zestawie znaków.
base64EncodeWebSafe(data)	String	Generuje zakodowany w internecie ciąg zakodowany w standardzie base-64 z podanej tablicy bajtów.
base64EncodeWebSafe(data)	String	Generuje z danego ciągu zakodowany w internecie ciąg zakodowany w standardzie base-64.
base64EncodeWebSafe(data, charset)	String	Generuje z danego ciągu zakodowany w internecie ciąg zakodowany w standardzie base-64 o określonym zestawie znaków.
computeDigest(algorithm, value)	Byte[]	Oblicz skrót za pomocą podanego algorytmu dla określonej wartości Byte[].
computeDigest(algorithm, value)	Byte[]	Oblicz skrót za pomocą podanego algorytmu dla określonej wartości String.
computeDigest(algorithm, value, charset)	Byte[]	Oblicz skrót przy użyciu podanego algorytmu dla określonej wartości String z argumentem danego zestawu znaków.
computeHmacSha256Signature(value, key)	Byte[]	Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z podanym kluczem.
computeHmacSha256Signature(value, key)	Byte[]	Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z podanym kluczem.
computeHmacSha256Signature(value, key, charset)	Byte[]	Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z podanym kluczem i zestawem znaków.
computeHmacSignature(algorithm, value, key)	Byte[]	Wygenerować kod uwierzytelniania wiadomości za pomocą podanego algorytmu dla określonego klucza i .
computeHmacSignature(algorithm, value, key)	Byte[]	Wygenerować kod uwierzytelniania wiadomości za pomocą podanego algorytmu dla określonego klucza i .
computeHmacSignature(algorithm, value, key, charset)	Byte[]	Wygenerować kod uwierzytelniania wiadomości za pomocą podanego algorytmu dla określonego klucza i .
computeRsaSha1Signature(value, key)	Byte[]	Podpisuje podaną wartość za pomocą RSA-SHA1 z podanym kluczem.
computeRsaSha1Signature(value, key, charset)	Byte[]	Podpisuje podaną wartość za pomocą RSA-SHA1 z podanym kluczem i zestawem znaków.
computeRsaSha256Signature(value, key)	Byte[]	Podpisuje podaną wartość za pomocą RSA-SHA256 z podanym kluczem.
computeRsaSha256Signature(value, key, charset)	Byte[]	Podpisuje podaną wartość za pomocą RSA-SHA256 z podanym kluczem.
computeRsaSignature(algorithm, value, key)	Byte[]	Podpisuje podaną wartość za pomocą określonego algorytmu RSA z podanym kluczem.
computeRsaSignature(algorithm, value, key, charset)	Byte[]	Podpisuje podaną wartość za pomocą określonego algorytmu RSA z podanym kluczem i zestawem znaków.
formatDate(date, timeZone, format)	String	Formatuje datę zgodnie ze specyfikacją opisaną w klasie Java SE SimpleDateFormat.
formatString(template, args)	String	Wykonuje formatowanie ciągów znaków w stylu sprintf, używając ciągów formatu „%”.
getUuid()	String	Pobierz identyfikator UUID w postaci ciągu znaków (odpowiednik metody java.util.UUID.randomUUID()).
gzip(blob)	Blob	gzip kompresuje podane dane Blob i zwraca je w nowym obiekcie Blob.
gzip(blob, name)	Blob	gzip kompresuje podane dane Blob i zwraca je w nowym obiekcie Blob.
newBlob(data)	Blob	Utwórz nowy obiekt Blob z tablicy bajtów.
newBlob(data, contentType)	Blob	Utwórz nowy obiekt Blob na podstawie tablicy bajtów i typu treści.
newBlob(data, contentType, name)	Blob	Utwórz nowy obiekt Blob na podstawie tablicy bajtów, typu treści i nazwy.
newBlob(data)	Blob	Utwórz nowy obiekt Blob na podstawie ciągu znaków.
newBlob(data, contentType)	Blob	Utwórz nowy obiekt Blob na podstawie ciągu znaków i typu treści.
newBlob(data, contentType, name)	Blob	Utwórz nowy obiekt Blob na podstawie ciągu znaków, typu treści i nazwy.
parseCsv(csv)	String[][]	Zwraca tabelaryczne reprezentację ciągu CSV w tablicy 2D.
parseCsv(csv, delimiter)	String[][]	Zwraca tabelaryczne reprezentację ciągu tekstowego CSV w formie tablicy 2D za pomocą niestandardowego separatora.
parseDate(date, timeZone, format)	Date	Analizuje datę podanego ciągu znaków zgodnie ze specyfikacją opisaną w standardzie Java Wersja SimpleDateFormat klasy.
sleep(milliseconds)	void	Uśpienie przez określoną liczbę milisekund.
ungzip(blob)	Blob	Rozpakowuje obiekt Blob i zwraca obiekt Blob zawierający nieskompresowany i skalowalnych danych.
unzip(blob)	Blob[]	Pobiera obiekt blob reprezentujący plik ZIP i zwraca pliki komponentu.
zip(blobs)	Blob	Tworzy nowy obiekt Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob.
zip(blobs, name)	Blob	Tworzy nowy obiekt Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
jsonParse(jsonString)	Object	Zwraca obiekt odpowiadający przekazywanemu ciągowi znaków JSON.
jsonStringify(obj)	String	Zwraca ciąg JSON przekazywanego obiektu.

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

Nazwa	Typ	Opis
encoded	String	Tablica bajtów danych do zdekodowania.

Powrót

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

Nazwa	Typ	Opis
encoded	String	Ciąg danych do zdekodowania.
charset	Charset	Charset określający zestaw znaków wejściowych.

Powrót

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

---

base64DecodeWebSafe(encoded)

Dekoduje ciąg zakodowany w formacie base64 w formacie internetowym do postaci tablicy bajtów 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

Nazwa	Typ	Opis
encoded	String	Tablica bajtów danych dostępnych w internecie do zdekodowania.

Powrót

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

---

base64DecodeWebSafe(encoded, charset)

Dekoduje ciąg zakodowany w standardzie base-64 w formacie internetowym 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

Nazwa	Typ	Opis
encoded	String	Ciąg danych dostępnych w internecie do zdekodowania.
charset	Charset	Charset określający zestaw znaków wejściowych.

Powrót

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

---

base64Encode(data)

Generuje ciąg zakodowany w standardzie base-64 z danej tablicy bajtów. Popularnym kodowaniem jest kodowanie Base64. przez różne narzędzia, które nie akceptują danych binarnych. Base 64 jest powszechnie używany protokoły internetowe, takie 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

Nazwa	Typ	Opis
data	Byte[]	Bajt[] danych do zakodowania.

Powrót

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

---

base64Encode(data)

Generuje ciąg zakodowany w standardzie base-64 z podanego ciągu. Jest to powszechnie akceptowane kodowanie Base64. za pomocą narzędzi, które nie akceptują danych binarnych. Kod Base 64 jest powszechnie używany w internecie. takimi jak poczta e-mail, HTTP czy dokumenty XML.

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

Parametry

Nazwa	Typ	Opis
data	String	Ciąg do zakodowania.

Powrót

String – reprezentacja ciągu tekstowego zakodowana w formacie base-64.

---

base64Encode(data, charset)

Generuje ciąg zakodowany w standardzie base-64 z danego ciągu o określonym zestawie znaków. Zestaw znaków to sposób kodowania znaków, aby można je było zakodować. Zwykle odbywa się to binarny, który może być zazwyczaj niezgodny z niektórymi protokołami przesyłania danych. Do zapewnić zgodność danych, są one zwykle kodowane w base64, który jest powszechnym kodowaniem. przez różne narzędzia, które nie akceptują danych binarnych. Base64 jest powszechnie używane protokoły internetowe, takie 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

Nazwa	Typ	Opis
data	String	Ciąg danych do zakodowania.
charset	Charset	Charset określający zestaw znaków wejściowych.

Powrót

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

---

base64EncodeWebSafe(data)

Generuje zakodowany w internecie ciąg zakodowany w standardzie base-64 z danej tablicy bajtów. Baza 64 jest typowa jest akceptowane przez różne narzędzia, które nie akceptują danych binarnych. Bezpieczne korzystanie z internetu w standardzie Base64 powszechnie stosowane w protokołach internetowych, takich jak poczta e-mail i HTTP, czy w dokumentach 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

Nazwa	Typ	Opis
data	Byte[]	Tablica bajtów danych do zakodowania.

Powrót

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

---

base64EncodeWebSafe(data)

Generuje z danego ciągu zakodowany w internecie ciąg zakodowany w standardzie base-64. Popularnym kodowaniem jest kodowanie Base64. przez różne narzędzia, które nie akceptują danych binarnych. Bezpieczne korzystanie z internetu przy użyciu kodeka Base64 jest często używanych w protokołach internetowych, takich jak poczta e-mail i HTTP, czy w dokumentach XML.

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

Parametry

Nazwa	Typ	Opis
data	String	Ciąg do zakodowania.

Powrót

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

---

base64EncodeWebSafe(data, charset)

Generuje z danego ciągu zakodowany w internecie ciąg zakodowany w standardzie base-64 o określonym zestawie znaków. Zestaw znaków to metoda kodowania znaków, która umożliwia ich kodowanie. Są to zwykle mają format binarny, który może być niezgodny z pewnymi procesami przesyłania danych. protokoły API. Aby zapewnić zgodność danych, są one zwykle kodowane w formacie base64, jest powszechnie stosowane przez różne narzędzia, które nie akceptują danych binarnych. Bezpieczne dla użytkowników internetu jest powszechnie stosowany w protokołach internetowych, takich jak poczta e-mail, HTTP, czy w dokumentach 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

Nazwa	Typ	Opis
data	String	Ciąg danych do zakodowania.
charset	Charset	Charset określający zestaw znaków wejściowych.

Powrót

String – bezpieczna w internecie reprezentacja ciągu znaków w formacie base-64 o określonym identyfikatorze Charset.

---

computeDigest(algorithm, value)

Oblicz skrót za pomocą podanego 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

Nazwa	Typ	Opis
algorithm	DigestAlgorithm	DigestAlgorithm do użycia.
value	Byte[]	Wartość wejściowego ciągu znaków do obliczenia skrótu.

Powrót

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

---

computeDigest(algorithm, value)

Oblicz skrót za pomocą podanego algorytmu dla określonej wartości String.

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

Parametry

Nazwa	Typ	Opis
algorithm	DigestAlgorithm	DigestAlgorithm do użycia.
value	String	Wartość wejściowego ciągu znaków do obliczenia skrótu.

Powrót

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

---

computeDigest(algorithm, value, charset)

Oblicz skrót przy użyciu podanego algorytmu dla określonej wartości String z argumentem danego zestawu znaków.

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

Parametry

Nazwa	Typ	Opis
algorithm	DigestAlgorithm	DigestAlgorithm do użycia.
value	String	Wartość wejściowego ciągu znaków do obliczenia skrótu.
charset	Charset	Charset reprezentujący wpisany zestaw znaków.

Powrót

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

---

computeHmacSha256Signature(value, key)

Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z podanym 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

Nazwa	Typ	Opis
value	Byte[]	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	Byte[]	Klucz używany do generowania haszu.

Powrót

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

---

computeHmacSha256Signature(value, key)

Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z podanym 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

Nazwa	Typ	Opis
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz używany do generowania haszu.

Powrót

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

---

computeHmacSha256Signature(value, key, charset)

Podpisuje podaną wartość za pomocą algorytmu HMAC-SHA256 z podanym 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

Nazwa	Typ	Opis
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz używany do generowania haszu.
charset	Charset	Charset reprezentujący wpisany zestaw znaków.

Powrót

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

---

computeHmacSignature(algorithm, value, key)

Wygenerować kod uwierzytelniania wiadomości za pomocą podanego algorytmu dla określonego klucza i .

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

Nazwa	Typ	Opis
algorithm	MacAlgorithm	Algorytm MacAlgorithm używany do haszowania wartości wejściowej.
value	Byte[]	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	Byte[]	Klucz używany do generowania haszu.

Powrót

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

---

computeHmacSignature(algorithm, value, key)

Wygenerować kod uwierzytelniania wiadomości za pomocą podanego algorytmu dla określonego klucza i .

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

Nazwa	Typ	Opis
algorithm	MacAlgorithm	Algorytm MacAlgorithm używany do haszowania wartości wejściowej.
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz używany do generowania haszu.

Powrót

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

---

computeHmacSignature(algorithm, value, key, charset)

Wygenerować kod uwierzytelniania wiadomości za pomocą podanego algorytmu dla określonego klucza i .

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

Nazwa	Typ	Opis
algorithm	MacAlgorithm	Algorytm MacAlgorithm używany do haszowania wartości wejściowej.
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz używany do generowania haszu.
charset	Charset	Charset reprezentujący wpisany zestaw znaków.

Powrót

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

---

computeRsaSha1Signature(value, key)

Podpisuje podaną wartość za pomocą RSA-SHA1 z podanym kluczem.

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

Nazwa	Typ	Opis
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz w formacie PEM używany do generowania podpisu.

Powrót

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

---

computeRsaSha1Signature(value, key, charset)

Podpisuje podaną wartość za pomocą RSA-SHA1 z podanym 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

Nazwa	Typ	Opis
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz w formacie PEM używany do generowania podpisu.
charset	Charset	Charset reprezentujący wpisany zestaw znaków.

Powrót

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

---

computeRsaSha256Signature(value, key)

Podpisuje podaną wartość za pomocą RSA-SHA256 z podanym kluczem.

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

Nazwa	Typ	Opis
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz w formacie PEM używany do generowania podpisu.

Powrót

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

---

computeRsaSha256Signature(value, key, charset)

Podpisuje podaną wartość za pomocą RSA-SHA256 z podanym kluczem.

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

Nazwa	Typ	Opis
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz w formacie PEM używany do generowania podpisu.
charset	Charset	Charset reprezentujący wpisany zestaw znaków.

Powrót

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

---

computeRsaSignature(algorithm, value, key)

Podpisuje podaną wartość za pomocą określonego algorytmu RSA z podanym kluczem.

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

Nazwa	Typ	Opis
algorithm	RsaAlgorithm	Algorytm RsaAlgorithm używany do haszowania wartości wejściowej.
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz w formacie PEM używany do generowania podpisu.

Powrót

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

---

computeRsaSignature(algorithm, value, key, charset)

Podpisuje podaną wartość za pomocą określonego algorytmu RSA z podanym 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

Nazwa	Typ	Opis
algorithm	RsaAlgorithm	Algorytm RsaAlgorithm używany do haszowania wartości wejściowej.
value	String	Wartość wejściowa na potrzeby wygenerowania skrótu.
key	String	Klucz w formacie PEM używany do generowania podpisu.
charset	Charset	Charset reprezentujący wpisany zestaw znaków.

Powrót

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

---

formatDate(date, timeZone, format)

Formatuje datę zgodnie ze specyfikacją opisaną w klasie Java SE SimpleDateFormat. Proszę 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

Nazwa	Typ	Opis
date	Date	Date do sformatowania jako ciąg znaków.
timeZone	String	Strefa czasowa wyjściowej wyniku.
format	String	Format zgodny ze specyfikacją SimpleDateFormat.

Powrót

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

---

formatString(template, args)

Wykonuje formatowanie ciągów znaków w stylu sprintf, używając ciągów formatu „%”.

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

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

Parametry

Nazwa	Typ	Opis
template	String	Ciąg tekstowy określający wartość zwracaną.
args	Object...	Obiekty, które mają być używane do wypełnienia parametru „%” zmienne w szablonie.

Powrót

String – sformatowany ciąg znaków.

---

getUuid()

Pobierz identyfikator UUID w postaci ciągu znaków (odpowiednik metody java.util.UUID.randomUUID()). Ten identyfikator nie musi być unikalny wśród wszystkich w czasie i przestrzeni. Dlatego nie używaj jej w sytuacjach, gdy wymagana jest 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();
};

Powrót

String – identyfikator UUID w postaci ciągu znaków.

---

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

Nazwa	Typ	Opis
blob	BlobSource	Obiekt Blob do skompresowania za pomocą gzip.

Powrót

Blob – nowy obiekt 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

Nazwa	Typ	Opis
blob	BlobSource	Obiekt Blob do skompresowania za pomocą gzip.
name	String	Nazwa pliku gzip do utworzenia.

Powrót

Blob – nowy obiekt Blob zawierający skompresowane dane.

---

newBlob(data)

Utwórz nowy obiekt Blob z tablicy bajtów. Obiekty blob są używane w wielu interfejsach API Apps Script, które pobierają 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

Nazwa	Typ	Opis
data	Byte[]	Liczba bajtów obiektu blob.

Powrót

Blob – nowo utworzony obiekt blob.

---

newBlob(data, contentType)

Utwórz nowy obiekt Blob na podstawie tablicy bajtów i typu treści. Obiekty blob są używane w wielu elementach Apps Script Interfejsy API, które przyjmują 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

Nazwa	Typ	Opis
data	Byte[]	Liczba bajtów obiektu blob.
contentType	String	Typ treści bloba – może być null.

Powrót

Blob – nowo utworzony obiekt blob.

---

newBlob(data, contentType, name)

Utwórz nowy obiekt Blob na podstawie tablicy bajtów, typu treści i nazwy. Obiekty blob są używane w wielu aplikacjach Interfejsy API skryptów, które jako dane wejściowe biorą dane binarne.

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

Nazwa	Typ	Opis
data	Byte[]	Liczba bajtów obiektu blob.
contentType	String	– typ treści bloba – może być null.
name	String	Nazwa bloba – może być „null”.

Powrót

Blob – nowo utworzony obiekt blob.

---

newBlob(data)

Utwórz nowy obiekt Blob na podstawie ciągu znaków. Obiekty blob są używane w wielu interfejsach API Apps Script, które pobierają 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

Nazwa	Typ	Opis
data	String	Ciąg znaków dla obiektu blob, przyjęto UTF-8.

Powrót

Blob – nowo utworzony obiekt blob.

---

newBlob(data, contentType)

Utwórz nowy obiekt Blob na podstawie ciągu znaków i typu treści. Obiekty blob są używane w wielu elementach Apps Script Interfejsy API, które przyjmują 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

Nazwa	Typ	Opis
data	String	Ciąg znaków dla obiektu blob, przyjęto UTF-8.
contentType	String	Typ treści bloba – może być null.

Powrót

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. Obiekty blob są używane w wielu aplikacjach Interfejsy API skryptów, które jako dane wejściowe biorą dane binarne.

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

Nazwa	Typ	Opis
data	String	Ciąg znaków dla obiektu blob, przyjęto UTF-8.
contentType	String	Typ treści bloba – może być null.
name	String	Nazwa bloba – może być „null”.

Powrót

Blob – nowo utworzony obiekt blob.

---

parseCsv(csv)

Zwraca tabelaryczne reprezentację ciągu CSV w tablicy 2D.

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

Parametry

Nazwa	Typ	Opis
csv	String	Ciąg tekstowy zawierający dane jedno- lub wielowierszowe w formacie CSV .

Powrót

String[][] – dwuwymiarowa tablica z wartościami w ciągu znaków CSV.

---

parseCsv(csv, delimiter)

Zwraca tabelaryczne reprezentację ciągu tekstowego CSV w formie tablicy 2D za pomocą 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

Nazwa	Typ	Opis
csv	String	Ciąg tekstowy zawierający dane jedno- lub wielowierszowe w formacie CSV .
delimiter	Char	Między wartościami.

Powrót

String[][] – dwuwymiarowa tablica z wartościami w ciągu znaków CSV.

---

parseDate(date, timeZone, format)

Analizuje datę podanego ciągu znaków zgodnie ze specyfikacją opisaną w standardzie Java Wersja SimpleDateFormat klasy. Więcej informacji znajdziesz w opisie klasy 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

Nazwa	Typ	Opis
date	String	Wartość ciągu tekstowego do przeanalizowania jako daty.
timeZone	String	Wyjściowa strefa czasowa.
format	String	Format daty zgodny ze specyfikacją SimpleDateFormat.

Powrót

Date – ciąg wejściowy jako data.

---

sleep(milliseconds)

Uśpienie przez określoną liczbę milisekund. Natychmiast uśpiony skrypt na czas z określoną liczbą milisekund. Maksymalna dozwolona wartość to 30 000 (lub 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

Nazwa	Typ	Opis
milliseconds	Integer	Liczba milisekund do uśpienia.

---

ungzip(blob)

Rozpakowuje obiekt Blob i zwraca obiekt Blob zawierający nieskompresowany i skalowalnych danych.

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

Nazwa	Typ	Opis
blob	BlobSource	Blob skompresowanych danych.

Powrót

Blob – Blob reprezentujący dane zdekompresowane.

---

unzip(blob)

Pobiera obiekt blob reprezentujący plik ZIP i zwraca 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

Nazwa	Typ	Opis
blob	BlobSource	Obiekt blob pliku ZIP.

Powrót

Blob[] – obiekt blob[] reprezentujący obiekty blob komponentu, nazwany pełną ścieżką wewnątrz tagu .zip.

---

zip(blobs)

Tworzy nowy obiekt 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

Nazwa	Typ	Opis
blobs	BlobSource[]	Tablica blobów do skompresowania.

Powrót

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

---

zip(blobs, name)

Tworzy nowy obiekt Blob w postaci pliku ZIP zawierającego dane z przekazanych obiektów blob. Ten wersji 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

Nazwa	Typ	Opis
blobs	BlobSource[]	Tablica blobów do skompresowania.
name	String	Nazwa pliku ZIP do utworzenia.

Powrót

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

Wycofane metody

jsonParse(jsonString)

Wycofano. Od listopada 2013 roku zastąpione przez JSON.parse()

Zwraca obiekt odpowiadający przekazywanemu ciągowi znaków JSON.

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

Parametry

Nazwa	Typ	Opis
jsonString	String	Reprezentacja obiektu JavaScript w postaci ciągu znaków do deserializacji.

Powrót

Object – obiektowa reprezentacja danych wejściowych w języku JavaScript.

---

jsonStringify(obj)

Wycofano. Od listopada 2013 roku zastąpione przez JSON.stringify()

Zwraca ciąg JSON przekazywanego obiektu.

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

Parametry

Nazwa	Typ	Opis
obj	Object	obiekt JavaScript do zserializacji do JSON

Powrót

String – zserializowany obiekt JavaScript w formacie JSON,